gitee.com/sy_183/go-common@v1.0.5-0.20231205030221-958cfe129b47/yaml/apic.go (about)

     1  // 
     2  // Copyright (c) 2011-2019 Canonical Ltd
     3  // Copyright (c) 2006-2010 Kirill Simonov
     4  // 
     5  // Permission is hereby granted, free of charge, to any person obtaining a copy of
     6  // this software and associated documentation files (the "Software"), to deal in
     7  // the Software without restriction, including without limitation the rights to
     8  // use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
     9  // of the Software, and to permit persons to whom the Software is furnished to do
    10  // so, subject to the following conditions:
    11  // 
    12  // The above copyright notice and this permission notice shall be included in all
    13  // copies or substantial portions of the Software.
    14  // 
    15  // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
    16  // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
    17  // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
    18  // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
    19  // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
    20  // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
    21  // SOFTWARE.
    22  
    23  package yaml
    24  
    25  import (
    26  	"io"
    27  )
    28  
    29  func yaml_insert_token(parser *yaml_parser_t, pos int, token *yaml_token_t) {
    30  	//fmt.Println("yaml_insert_token", "pos:", pos, "typ:", token.typ, "head:", parser.tokens_head, "len:", len(parser.tokens))
    31  
    32  	// Check if we can move the queue at the beginning of the buffer.
    33  	if parser.tokens_head > 0 && len(parser.tokens) == cap(parser.tokens) {
    34  		if parser.tokens_head != len(parser.tokens) {
    35  			copy(parser.tokens, parser.tokens[parser.tokens_head:])
    36  		}
    37  		parser.tokens = parser.tokens[:len(parser.tokens)-parser.tokens_head]
    38  		parser.tokens_head = 0
    39  	}
    40  	parser.tokens = append(parser.tokens, *token)
    41  	if pos < 0 {
    42  		return
    43  	}
    44  	copy(parser.tokens[parser.tokens_head+pos+1:], parser.tokens[parser.tokens_head+pos:])
    45  	parser.tokens[parser.tokens_head+pos] = *token
    46  }
    47  
    48  // Create a new parser object.
    49  func yaml_parser_initialize(parser *yaml_parser_t) bool {
    50  	*parser = yaml_parser_t{
    51  		raw_buffer: make([]byte, 0, input_raw_buffer_size),
    52  		buffer:     make([]byte, 0, input_buffer_size),
    53  	}
    54  	return true
    55  }
    56  
    57  // Destroy a parser object.
    58  func yaml_parser_delete(parser *yaml_parser_t) {
    59  	*parser = yaml_parser_t{}
    60  }
    61  
    62  // String read handler.
    63  func yaml_string_read_handler(parser *yaml_parser_t, buffer []byte) (n int, err error) {
    64  	if parser.input_pos == len(parser.input) {
    65  		return 0, io.EOF
    66  	}
    67  	n = copy(buffer, parser.input[parser.input_pos:])
    68  	parser.input_pos += n
    69  	return n, nil
    70  }
    71  
    72  // Reader read handler.
    73  func yaml_reader_read_handler(parser *yaml_parser_t, buffer []byte) (n int, err error) {
    74  	return parser.input_reader.Read(buffer)
    75  }
    76  
    77  // Set a string input.
    78  func yaml_parser_set_input_string(parser *yaml_parser_t, input []byte) {
    79  	if parser.read_handler != nil {
    80  		panic("must set the input source only once")
    81  	}
    82  	parser.read_handler = yaml_string_read_handler
    83  	parser.input = input
    84  	parser.input_pos = 0
    85  }
    86  
    87  // Set a file input.
    88  func yaml_parser_set_input_reader(parser *yaml_parser_t, r io.Reader) {
    89  	if parser.read_handler != nil {
    90  		panic("must set the input source only once")
    91  	}
    92  	parser.read_handler = yaml_reader_read_handler
    93  	parser.input_reader = r
    94  }
    95  
    96  // Set the source encoding.
    97  func yaml_parser_set_encoding(parser *yaml_parser_t, encoding yaml_encoding_t) {
    98  	if parser.encoding != yaml_ANY_ENCODING {
    99  		panic("must set the encoding only once")
   100  	}
   101  	parser.encoding = encoding
   102  }
   103  
   104  // Create a new emitter object.
   105  func yaml_emitter_initialize(emitter *yaml_emitter_t) {
   106  	*emitter = yaml_emitter_t{
   107  		buffer:     make([]byte, output_buffer_size),
   108  		raw_buffer: make([]byte, 0, output_raw_buffer_size),
   109  		states:     make([]yaml_emitter_state_t, 0, initial_stack_size),
   110  		events:     make([]yaml_event_t, 0, initial_queue_size),
   111  		best_width: -1,
   112  	}
   113  }
   114  
   115  // Destroy an emitter object.
   116  func yaml_emitter_delete(emitter *yaml_emitter_t) {
   117  	*emitter = yaml_emitter_t{}
   118  }
   119  
   120  // String write handler.
   121  func yaml_string_write_handler(emitter *yaml_emitter_t, buffer []byte) error {
   122  	*emitter.output_buffer = append(*emitter.output_buffer, buffer...)
   123  	return nil
   124  }
   125  
   126  // yaml_writer_write_handler uses emitter.output_writer to write the
   127  // emitted text.
   128  func yaml_writer_write_handler(emitter *yaml_emitter_t, buffer []byte) error {
   129  	_, err := emitter.output_writer.Write(buffer)
   130  	return err
   131  }
   132  
   133  // Set a string output.
   134  func yaml_emitter_set_output_string(emitter *yaml_emitter_t, output_buffer *[]byte) {
   135  	if emitter.write_handler != nil {
   136  		panic("must set the output target only once")
   137  	}
   138  	emitter.write_handler = yaml_string_write_handler
   139  	emitter.output_buffer = output_buffer
   140  }
   141  
   142  // Set a file output.
   143  func yaml_emitter_set_output_writer(emitter *yaml_emitter_t, w io.Writer) {
   144  	if emitter.write_handler != nil {
   145  		panic("must set the output target only once")
   146  	}
   147  	emitter.write_handler = yaml_writer_write_handler
   148  	emitter.output_writer = w
   149  }
   150  
   151  // Set the output encoding.
   152  func yaml_emitter_set_encoding(emitter *yaml_emitter_t, encoding yaml_encoding_t) {
   153  	if emitter.encoding != yaml_ANY_ENCODING {
   154  		panic("must set the output encoding only once")
   155  	}
   156  	emitter.encoding = encoding
   157  }
   158  
   159  // Set the canonical output style.
   160  func yaml_emitter_set_canonical(emitter *yaml_emitter_t, canonical bool) {
   161  	emitter.canonical = canonical
   162  }
   163  
   164  // Set the indentation increment.
   165  func yaml_emitter_set_indent(emitter *yaml_emitter_t, indent int) {
   166  	if indent < 2 || indent > 9 {
   167  		indent = 2
   168  	}
   169  	emitter.best_indent = indent
   170  }
   171  
   172  // Set the preferred line width.
   173  func yaml_emitter_set_width(emitter *yaml_emitter_t, width int) {
   174  	if width < 0 {
   175  		width = -1
   176  	}
   177  	emitter.best_width = width
   178  }
   179  
   180  // Set if unescaped non-ASCII characters are allowed.
   181  func yaml_emitter_set_unicode(emitter *yaml_emitter_t, unicode bool) {
   182  	emitter.unicode = unicode
   183  }
   184  
   185  // Set the preferred line break character.
   186  func yaml_emitter_set_break(emitter *yaml_emitter_t, line_break yaml_break_t) {
   187  	emitter.line_break = line_break
   188  }
   189  
   190  ///*
   191  // * Destroy a token object.
   192  // */
   193  //
   194  //YAML_DECLARE(void)
   195  //yaml_token_delete(yaml_token_t *token)
   196  //{
   197  //    assert(token);  // Non-NULL token object expected.
   198  //
   199  //    switch (token.type)
   200  //    {
   201  //        case YAML_TAG_DIRECTIVE_TOKEN:
   202  //            yaml_free(token.data.tag_directive.handle);
   203  //            yaml_free(token.data.tag_directive.prefix);
   204  //            break;
   205  //
   206  //        case YAML_ALIAS_TOKEN:
   207  //            yaml_free(token.data.alias.value);
   208  //            break;
   209  //
   210  //        case YAML_ANCHOR_TOKEN:
   211  //            yaml_free(token.data.anchor.value);
   212  //            break;
   213  //
   214  //        case YAML_TAG_TOKEN:
   215  //            yaml_free(token.data.tag.handle);
   216  //            yaml_free(token.data.tag.suffix);
   217  //            break;
   218  //
   219  //        case YAML_SCALAR_TOKEN:
   220  //            yaml_free(token.data.scalar.value);
   221  //            break;
   222  //
   223  //        default:
   224  //            break;
   225  //    }
   226  //
   227  //    memset(token, 0, sizeof(yaml_token_t));
   228  //}
   229  //
   230  ///*
   231  // * Check if a string is a valid UTF-8 sequence.
   232  // *
   233  // * Check 'reader.c' for more details on UTF-8 encoding.
   234  // */
   235  //
   236  //static int
   237  //yaml_check_utf8(yaml_char_t *start, size_t length)
   238  //{
   239  //    yaml_char_t *end = start+length;
   240  //    yaml_char_t *pointer = start;
   241  //
   242  //    while (pointer < end) {
   243  //        unsigned char octet;
   244  //        unsigned int width;
   245  //        unsigned int value;
   246  //        size_t k;
   247  //
   248  //        octet = pointer[0];
   249  //        width = (octet & 0x80) == 0x00 ? 1 :
   250  //                (octet & 0xE0) == 0xC0 ? 2 :
   251  //                (octet & 0xF0) == 0xE0 ? 3 :
   252  //                (octet & 0xF8) == 0xF0 ? 4 : 0;
   253  //        value = (octet & 0x80) == 0x00 ? octet & 0x7F :
   254  //                (octet & 0xE0) == 0xC0 ? octet & 0x1F :
   255  //                (octet & 0xF0) == 0xE0 ? octet & 0x0F :
   256  //                (octet & 0xF8) == 0xF0 ? octet & 0x07 : 0;
   257  //        if (!width) return 0;
   258  //        if (pointer+width > end) return 0;
   259  //        for (k = 1; k < width; k ++) {
   260  //            octet = pointer[k];
   261  //            if ((octet & 0xC0) != 0x80) return 0;
   262  //            value = (value << 6) + (octet & 0x3F);
   263  //        }
   264  //        if (!((width == 1) ||
   265  //            (width == 2 && value >= 0x80) ||
   266  //            (width == 3 && value >= 0x800) ||
   267  //            (width == 4 && value >= 0x10000))) return 0;
   268  //
   269  //        pointer += width;
   270  //    }
   271  //
   272  //    return 1;
   273  //}
   274  //
   275  
   276  // Create STREAM-START.
   277  func yaml_stream_start_event_initialize(event *yaml_event_t, encoding yaml_encoding_t) {
   278  	*event = yaml_event_t{
   279  		typ:      yaml_STREAM_START_EVENT,
   280  		encoding: encoding,
   281  	}
   282  }
   283  
   284  // Create STREAM-END.
   285  func yaml_stream_end_event_initialize(event *yaml_event_t) {
   286  	*event = yaml_event_t{
   287  		typ: yaml_STREAM_END_EVENT,
   288  	}
   289  }
   290  
   291  // Create DOCUMENT-START.
   292  func yaml_document_start_event_initialize(
   293  	event *yaml_event_t,
   294  	version_directive *yaml_version_directive_t,
   295  	tag_directives []yaml_tag_directive_t,
   296  	implicit bool,
   297  ) {
   298  	*event = yaml_event_t{
   299  		typ:               yaml_DOCUMENT_START_EVENT,
   300  		version_directive: version_directive,
   301  		tag_directives:    tag_directives,
   302  		implicit:          implicit,
   303  	}
   304  }
   305  
   306  // Create DOCUMENT-END.
   307  func yaml_document_end_event_initialize(event *yaml_event_t, implicit bool) {
   308  	*event = yaml_event_t{
   309  		typ:      yaml_DOCUMENT_END_EVENT,
   310  		implicit: implicit,
   311  	}
   312  }
   313  
   314  // Create ALIAS.
   315  func yaml_alias_event_initialize(event *yaml_event_t, anchor []byte) bool {
   316  	*event = yaml_event_t{
   317  		typ:    yaml_ALIAS_EVENT,
   318  		anchor: anchor,
   319  	}
   320  	return true
   321  }
   322  
   323  // Create SCALAR.
   324  func yaml_scalar_event_initialize(event *yaml_event_t, anchor, tag, value []byte, plain_implicit, quoted_implicit bool, style yaml_scalar_style_t) bool {
   325  	*event = yaml_event_t{
   326  		typ:             yaml_SCALAR_EVENT,
   327  		anchor:          anchor,
   328  		tag:             tag,
   329  		value:           value,
   330  		implicit:        plain_implicit,
   331  		quoted_implicit: quoted_implicit,
   332  		style:           yaml_style_t(style),
   333  	}
   334  	return true
   335  }
   336  
   337  // Create SEQUENCE-START.
   338  func yaml_sequence_start_event_initialize(event *yaml_event_t, anchor, tag []byte, implicit bool, style yaml_sequence_style_t) bool {
   339  	*event = yaml_event_t{
   340  		typ:      yaml_SEQUENCE_START_EVENT,
   341  		anchor:   anchor,
   342  		tag:      tag,
   343  		implicit: implicit,
   344  		style:    yaml_style_t(style),
   345  	}
   346  	return true
   347  }
   348  
   349  // Create SEQUENCE-END.
   350  func yaml_sequence_end_event_initialize(event *yaml_event_t) bool {
   351  	*event = yaml_event_t{
   352  		typ: yaml_SEQUENCE_END_EVENT,
   353  	}
   354  	return true
   355  }
   356  
   357  // Create MAPPING-START.
   358  func yaml_mapping_start_event_initialize(event *yaml_event_t, anchor, tag []byte, implicit bool, style yaml_mapping_style_t) {
   359  	*event = yaml_event_t{
   360  		typ:      yaml_MAPPING_START_EVENT,
   361  		anchor:   anchor,
   362  		tag:      tag,
   363  		implicit: implicit,
   364  		style:    yaml_style_t(style),
   365  	}
   366  }
   367  
   368  // Create MAPPING-END.
   369  func yaml_mapping_end_event_initialize(event *yaml_event_t) {
   370  	*event = yaml_event_t{
   371  		typ: yaml_MAPPING_END_EVENT,
   372  	}
   373  }
   374  
   375  // Destroy an event object.
   376  func yaml_event_delete(event *yaml_event_t) {
   377  	*event = yaml_event_t{}
   378  }
   379  
   380  ///*
   381  // * Create a document object.
   382  // */
   383  //
   384  //YAML_DECLARE(int)
   385  //yaml_document_initialize(document *yaml_document_t,
   386  //        version_directive *yaml_version_directive_t,
   387  //        tag_directives_start *yaml_tag_directive_t,
   388  //        tag_directives_end *yaml_tag_directive_t,
   389  //        start_implicit int, end_implicit int)
   390  //{
   391  //    struct {
   392  //        error yaml_error_type_t
   393  //    } context
   394  //    struct {
   395  //        start *yaml_node_t
   396  //        end *yaml_node_t
   397  //        top *yaml_node_t
   398  //    } nodes = { NULL, NULL, NULL }
   399  //    version_directive_copy *yaml_version_directive_t = NULL
   400  //    struct {
   401  //        start *yaml_tag_directive_t
   402  //        end *yaml_tag_directive_t
   403  //        top *yaml_tag_directive_t
   404  //    } tag_directives_copy = { NULL, NULL, NULL }
   405  //    value yaml_tag_directive_t = { NULL, NULL }
   406  //    mark yaml_mark_t = { 0, 0, 0 }
   407  //
   408  //    assert(document) // Non-NULL document object is expected.
   409  //    assert((tag_directives_start && tag_directives_end) ||
   410  //            (tag_directives_start == tag_directives_end))
   411  //                            // Valid tag directives are expected.
   412  //
   413  //    if (!STACK_INIT(&context, nodes, INITIAL_STACK_SIZE)) goto error
   414  //
   415  //    if (version_directive) {
   416  //        version_directive_copy = yaml_malloc(sizeof(yaml_version_directive_t))
   417  //        if (!version_directive_copy) goto error
   418  //        version_directive_copy.major = version_directive.major
   419  //        version_directive_copy.minor = version_directive.minor
   420  //    }
   421  //
   422  //    if (tag_directives_start != tag_directives_end) {
   423  //        tag_directive *yaml_tag_directive_t
   424  //        if (!STACK_INIT(&context, tag_directives_copy, INITIAL_STACK_SIZE))
   425  //            goto error
   426  //        for (tag_directive = tag_directives_start
   427  //                tag_directive != tag_directives_end; tag_directive ++) {
   428  //            assert(tag_directive.handle)
   429  //            assert(tag_directive.prefix)
   430  //            if (!yaml_check_utf8(tag_directive.handle,
   431  //                        strlen((char *)tag_directive.handle)))
   432  //                goto error
   433  //            if (!yaml_check_utf8(tag_directive.prefix,
   434  //                        strlen((char *)tag_directive.prefix)))
   435  //                goto error
   436  //            value.handle = yaml_strdup(tag_directive.handle)
   437  //            value.prefix = yaml_strdup(tag_directive.prefix)
   438  //            if (!value.handle || !value.prefix) goto error
   439  //            if (!PUSH(&context, tag_directives_copy, value))
   440  //                goto error
   441  //            value.handle = NULL
   442  //            value.prefix = NULL
   443  //        }
   444  //    }
   445  //
   446  //    DOCUMENT_INIT(*document, nodes.start, nodes.end, version_directive_copy,
   447  //            tag_directives_copy.start, tag_directives_copy.top,
   448  //            start_implicit, end_implicit, mark, mark)
   449  //
   450  //    return 1
   451  //
   452  //error:
   453  //    STACK_DEL(&context, nodes)
   454  //    yaml_free(version_directive_copy)
   455  //    while (!STACK_EMPTY(&context, tag_directives_copy)) {
   456  //        value yaml_tag_directive_t = POP(&context, tag_directives_copy)
   457  //        yaml_free(value.handle)
   458  //        yaml_free(value.prefix)
   459  //    }
   460  //    STACK_DEL(&context, tag_directives_copy)
   461  //    yaml_free(value.handle)
   462  //    yaml_free(value.prefix)
   463  //
   464  //    return 0
   465  //}
   466  //
   467  ///*
   468  // * Destroy a document object.
   469  // */
   470  //
   471  //YAML_DECLARE(void)
   472  //yaml_document_delete(document *yaml_document_t)
   473  //{
   474  //    struct {
   475  //        error yaml_error_type_t
   476  //    } context
   477  //    tag_directive *yaml_tag_directive_t
   478  //
   479  //    context.error = YAML_NO_ERROR // Eliminate a compiler warning.
   480  //
   481  //    assert(document) // Non-NULL document object is expected.
   482  //
   483  //    while (!STACK_EMPTY(&context, document.nodes)) {
   484  //        node yaml_node_t = POP(&context, document.nodes)
   485  //        yaml_free(node.tag)
   486  //        switch (node.type) {
   487  //            case YAML_SCALAR_NODE:
   488  //                yaml_free(node.data.scalar.value)
   489  //                break
   490  //            case YAML_SEQUENCE_NODE:
   491  //                STACK_DEL(&context, node.data.sequence.items)
   492  //                break
   493  //            case YAML_MAPPING_NODE:
   494  //                STACK_DEL(&context, node.data.mapping.pairs)
   495  //                break
   496  //            default:
   497  //                assert(0) // Should not happen.
   498  //        }
   499  //    }
   500  //    STACK_DEL(&context, document.nodes)
   501  //
   502  //    yaml_free(document.version_directive)
   503  //    for (tag_directive = document.tag_directives.start
   504  //            tag_directive != document.tag_directives.end
   505  //            tag_directive++) {
   506  //        yaml_free(tag_directive.handle)
   507  //        yaml_free(tag_directive.prefix)
   508  //    }
   509  //    yaml_free(document.tag_directives.start)
   510  //
   511  //    memset(document, 0, sizeof(yaml_document_t))
   512  //}
   513  //
   514  ///**
   515  // * Get a document node.
   516  // */
   517  //
   518  //YAML_DECLARE(yaml_node_t *)
   519  //yaml_document_get_node(document *yaml_document_t, index int)
   520  //{
   521  //    assert(document) // Non-NULL document object is expected.
   522  //
   523  //    if (index > 0 && document.nodes.start + index <= document.nodes.top) {
   524  //        return document.nodes.start + index - 1
   525  //    }
   526  //    return NULL
   527  //}
   528  //
   529  ///**
   530  // * Get the root object.
   531  // */
   532  //
   533  //YAML_DECLARE(yaml_node_t *)
   534  //yaml_document_get_root_node(document *yaml_document_t)
   535  //{
   536  //    assert(document) // Non-NULL document object is expected.
   537  //
   538  //    if (document.nodes.top != document.nodes.start) {
   539  //        return document.nodes.start
   540  //    }
   541  //    return NULL
   542  //}
   543  //
   544  ///*
   545  // * Add a scalar node to a document.
   546  // */
   547  //
   548  //YAML_DECLARE(int)
   549  //yaml_document_add_scalar(document *yaml_document_t,
   550  //        tag *yaml_char_t, value *yaml_char_t, length int,
   551  //        style yaml_scalar_style_t)
   552  //{
   553  //    struct {
   554  //        error yaml_error_type_t
   555  //    } context
   556  //    mark yaml_mark_t = { 0, 0, 0 }
   557  //    tag_copy *yaml_char_t = NULL
   558  //    value_copy *yaml_char_t = NULL
   559  //    node yaml_node_t
   560  //
   561  //    assert(document) // Non-NULL document object is expected.
   562  //    assert(value) // Non-NULL value is expected.
   563  //
   564  //    if (!tag) {
   565  //        tag = (yaml_char_t *)YAML_DEFAULT_SCALAR_TAG
   566  //    }
   567  //
   568  //    if (!yaml_check_utf8(tag, strlen((char *)tag))) goto error
   569  //    tag_copy = yaml_strdup(tag)
   570  //    if (!tag_copy) goto error
   571  //
   572  //    if (length < 0) {
   573  //        length = strlen((char *)value)
   574  //    }
   575  //
   576  //    if (!yaml_check_utf8(value, length)) goto error
   577  //    value_copy = yaml_malloc(length+1)
   578  //    if (!value_copy) goto error
   579  //    memcpy(value_copy, value, length)
   580  //    value_copy[length] = '\0'
   581  //
   582  //    SCALAR_NODE_INIT(node, tag_copy, value_copy, length, style, mark, mark)
   583  //    if (!PUSH(&context, document.nodes, node)) goto error
   584  //
   585  //    return document.nodes.top - document.nodes.start
   586  //
   587  //error:
   588  //    yaml_free(tag_copy)
   589  //    yaml_free(value_copy)
   590  //
   591  //    return 0
   592  //}
   593  //
   594  ///*
   595  // * Add a sequence node to a document.
   596  // */
   597  //
   598  //YAML_DECLARE(int)
   599  //yaml_document_add_sequence(document *yaml_document_t,
   600  //        tag *yaml_char_t, style yaml_sequence_style_t)
   601  //{
   602  //    struct {
   603  //        error yaml_error_type_t
   604  //    } context
   605  //    mark yaml_mark_t = { 0, 0, 0 }
   606  //    tag_copy *yaml_char_t = NULL
   607  //    struct {
   608  //        start *yaml_node_item_t
   609  //        end *yaml_node_item_t
   610  //        top *yaml_node_item_t
   611  //    } items = { NULL, NULL, NULL }
   612  //    node yaml_node_t
   613  //
   614  //    assert(document) // Non-NULL document object is expected.
   615  //
   616  //    if (!tag) {
   617  //        tag = (yaml_char_t *)YAML_DEFAULT_SEQUENCE_TAG
   618  //    }
   619  //
   620  //    if (!yaml_check_utf8(tag, strlen((char *)tag))) goto error
   621  //    tag_copy = yaml_strdup(tag)
   622  //    if (!tag_copy) goto error
   623  //
   624  //    if (!STACK_INIT(&context, items, INITIAL_STACK_SIZE)) goto error
   625  //
   626  //    SEQUENCE_NODE_INIT(node, tag_copy, items.start, items.end,
   627  //            style, mark, mark)
   628  //    if (!PUSH(&context, document.nodes, node)) goto error
   629  //
   630  //    return document.nodes.top - document.nodes.start
   631  //
   632  //error:
   633  //    STACK_DEL(&context, items)
   634  //    yaml_free(tag_copy)
   635  //
   636  //    return 0
   637  //}
   638  //
   639  ///*
   640  // * Add a mapping node to a document.
   641  // */
   642  //
   643  //YAML_DECLARE(int)
   644  //yaml_document_add_mapping(document *yaml_document_t,
   645  //        tag *yaml_char_t, style yaml_mapping_style_t)
   646  //{
   647  //    struct {
   648  //        error yaml_error_type_t
   649  //    } context
   650  //    mark yaml_mark_t = { 0, 0, 0 }
   651  //    tag_copy *yaml_char_t = NULL
   652  //    struct {
   653  //        start *yaml_node_pair_t
   654  //        end *yaml_node_pair_t
   655  //        top *yaml_node_pair_t
   656  //    } pairs = { NULL, NULL, NULL }
   657  //    node yaml_node_t
   658  //
   659  //    assert(document) // Non-NULL document object is expected.
   660  //
   661  //    if (!tag) {
   662  //        tag = (yaml_char_t *)YAML_DEFAULT_MAPPING_TAG
   663  //    }
   664  //
   665  //    if (!yaml_check_utf8(tag, strlen((char *)tag))) goto error
   666  //    tag_copy = yaml_strdup(tag)
   667  //    if (!tag_copy) goto error
   668  //
   669  //    if (!STACK_INIT(&context, pairs, INITIAL_STACK_SIZE)) goto error
   670  //
   671  //    MAPPING_NODE_INIT(node, tag_copy, pairs.start, pairs.end,
   672  //            style, mark, mark)
   673  //    if (!PUSH(&context, document.nodes, node)) goto error
   674  //
   675  //    return document.nodes.top - document.nodes.start
   676  //
   677  //error:
   678  //    STACK_DEL(&context, pairs)
   679  //    yaml_free(tag_copy)
   680  //
   681  //    return 0
   682  //}
   683  //
   684  ///*
   685  // * Append an item to a sequence node.
   686  // */
   687  //
   688  //YAML_DECLARE(int)
   689  //yaml_document_append_sequence_item(document *yaml_document_t,
   690  //        sequence int, item int)
   691  //{
   692  //    struct {
   693  //        error yaml_error_type_t
   694  //    } context
   695  //
   696  //    assert(document) // Non-NULL document is required.
   697  //    assert(sequence > 0
   698  //            && document.nodes.start + sequence <= document.nodes.top)
   699  //                            // Valid sequence id is required.
   700  //    assert(document.nodes.start[sequence-1].type == YAML_SEQUENCE_NODE)
   701  //                            // A sequence node is required.
   702  //    assert(item > 0 && document.nodes.start + item <= document.nodes.top)
   703  //                            // Valid item id is required.
   704  //
   705  //    if (!PUSH(&context,
   706  //                document.nodes.start[sequence-1].data.sequence.items, item))
   707  //        return 0
   708  //
   709  //    return 1
   710  //}
   711  //
   712  ///*
   713  // * Append a pair of a key and a value to a mapping node.
   714  // */
   715  //
   716  //YAML_DECLARE(int)
   717  //yaml_document_append_mapping_pair(document *yaml_document_t,
   718  //        mapping int, key int, value int)
   719  //{
   720  //    struct {
   721  //        error yaml_error_type_t
   722  //    } context
   723  //
   724  //    pair yaml_node_pair_t
   725  //
   726  //    assert(document) // Non-NULL document is required.
   727  //    assert(mapping > 0
   728  //            && document.nodes.start + mapping <= document.nodes.top)
   729  //                            // Valid mapping id is required.
   730  //    assert(document.nodes.start[mapping-1].type == YAML_MAPPING_NODE)
   731  //                            // A mapping node is required.
   732  //    assert(key > 0 && document.nodes.start + key <= document.nodes.top)
   733  //                            // Valid key id is required.
   734  //    assert(value > 0 && document.nodes.start + value <= document.nodes.top)
   735  //                            // Valid value id is required.
   736  //
   737  //    pair.key = key
   738  //    pair.value = value
   739  //
   740  //    if (!PUSH(&context,
   741  //                document.nodes.start[mapping-1].data.mapping.pairs, pair))
   742  //        return 0
   743  //
   744  //    return 1
   745  //}
   746  //
   747  //