xref: /freebsd/contrib/libyaml/src/yaml_private.h (revision 0f5c86ddb0257f4b7620f1d8e898289be30b19bf)
1 #if HAVE_CONFIG_H
2 #include "config.h"
3 #endif
4 
5 #include <yaml.h>
6 
7 #include <assert.h>
8 #include <limits.h>
9 #include <stddef.h>
10 
11 /*
12  * Memory management.
13  */
14 
15 YAML_DECLARE(void *)
16 yaml_malloc(size_t size);
17 
18 YAML_DECLARE(void *)
19 yaml_realloc(void *ptr, size_t size);
20 
21 YAML_DECLARE(void)
22 yaml_free(void *ptr);
23 
24 YAML_DECLARE(yaml_char_t *)
25 yaml_strdup(const yaml_char_t *);
26 
27 /*
28  * Reader: Ensure that the buffer contains at least `length` characters.
29  */
30 
31 YAML_DECLARE(int)
32 yaml_parser_update_buffer(yaml_parser_t *parser, size_t length);
33 
34 /*
35  * Scanner: Ensure that the token stack contains at least one token ready.
36  */
37 
38 YAML_DECLARE(int)
39 yaml_parser_fetch_more_tokens(yaml_parser_t *parser);
40 
41 /*
42  * The size of the input raw buffer.
43  */
44 
45 #define INPUT_RAW_BUFFER_SIZE   16384
46 
47 /*
48  * The size of the input buffer.
49  *
50  * It should be possible to decode the whole raw buffer.
51  */
52 
53 #define INPUT_BUFFER_SIZE       (INPUT_RAW_BUFFER_SIZE*3)
54 
55 /*
56  * The size of the output buffer.
57  */
58 
59 #define OUTPUT_BUFFER_SIZE      16384
60 
61 /*
62  * The size of the output raw buffer.
63  *
64  * It should be possible to encode the whole output buffer.
65  */
66 
67 #define OUTPUT_RAW_BUFFER_SIZE  (OUTPUT_BUFFER_SIZE*2+2)
68 
69 /*
70  * The maximum size of a YAML input file.
71  * This used to be PTRDIFF_MAX, but that's not entirely portable
72  * because stdint.h isn't available on all platforms.
73  * It is not entirely clear why this isn't the maximum value
74  * that can fit into the parser->offset field.
75  */
76 
77 #define MAX_FILE_SIZE (~(size_t)0 / 2)
78 
79 
80 /*
81  * The size of other stacks and queues.
82  */
83 
84 #define INITIAL_STACK_SIZE  16
85 #define INITIAL_QUEUE_SIZE  16
86 #define INITIAL_STRING_SIZE 16
87 
88 /*
89  * Buffer management.
90  */
91 
92 #define BUFFER_INIT(context,buffer,size)                                        \
93   (((buffer).start = (yaml_char_t *)yaml_malloc(size)) ?                        \
94         ((buffer).last = (buffer).pointer = (buffer).start,                     \
95          (buffer).end = (buffer).start+(size),                                  \
96          1) :                                                                   \
97         ((context)->error = YAML_MEMORY_ERROR,                                  \
98          0))
99 
100 #define BUFFER_DEL(context,buffer)                                              \
101     (yaml_free((buffer).start),                                                 \
102      (buffer).start = (buffer).pointer = (buffer).end = 0)
103 
104 /*
105  * String management.
106  */
107 
108 typedef struct {
109     yaml_char_t *start;
110     yaml_char_t *end;
111     yaml_char_t *pointer;
112 } yaml_string_t;
113 
114 YAML_DECLARE(int)
115 yaml_string_extend(yaml_char_t **start,
116         yaml_char_t **pointer, yaml_char_t **end);
117 
118 YAML_DECLARE(int)
119 yaml_string_join(
120         yaml_char_t **a_start, yaml_char_t **a_pointer, yaml_char_t **a_end,
121         yaml_char_t **b_start, yaml_char_t **b_pointer, yaml_char_t **b_end);
122 
123 #define NULL_STRING { NULL, NULL, NULL }
124 
125 #define STRING(string,length)   { (string), (string)+(length), (string) }
126 
127 #define STRING_ASSIGN(value,string,length)                                      \
128     ((value).start = (string),                                                  \
129      (value).end = (string)+(length),                                           \
130      (value).pointer = (string))
131 
132 #define STRING_INIT(context,string,size)                                        \
133     (((string).start = YAML_MALLOC(size)) ?                                     \
134         ((string).pointer = (string).start,                                     \
135          (string).end = (string).start+(size),                                  \
136          memset((string).start, 0, (size)),                                     \
137          1) :                                                                   \
138         ((context)->error = YAML_MEMORY_ERROR,                                  \
139          0))
140 
141 #define STRING_DEL(context,string)                                              \
142     (yaml_free((string).start),                                                 \
143      (string).start = (string).pointer = (string).end = 0)
144 
145 #define STRING_EXTEND(context,string)                                           \
146     ((((string).pointer+5 < (string).end)                                       \
147         || yaml_string_extend(&(string).start,                                  \
148             &(string).pointer, &(string).end)) ?                                \
149          1 :                                                                    \
150         ((context)->error = YAML_MEMORY_ERROR,                                  \
151          0))
152 
153 #define CLEAR(context,string)                                                   \
154     ((string).pointer = (string).start,                                         \
155      memset((string).start, 0, (string).end-(string).start))
156 
157 #define JOIN(context,string_a,string_b)                                         \
158     ((yaml_string_join(&(string_a).start, &(string_a).pointer,                  \
159                        &(string_a).end, &(string_b).start,                      \
160                        &(string_b).pointer, &(string_b).end)) ?                 \
161         ((string_b).pointer = (string_b).start,                                 \
162          1) :                                                                   \
163         ((context)->error = YAML_MEMORY_ERROR,                                  \
164          0))
165 
166 /*
167  * String check operations.
168  */
169 
170 /*
171  * Check the octet at the specified position.
172  */
173 
174 #define CHECK_AT(string,octet,offset)                   \
175     ((string).pointer[offset] == (yaml_char_t)(octet))
176 
177 /*
178  * Check the current octet in the buffer.
179  */
180 
181 #define CHECK(string,octet) (CHECK_AT((string),(octet),0))
182 
183 /*
184  * Check if the character at the specified position is an alphabetical
185  * character, a digit, '_', or '-'.
186  */
187 
188 #define IS_ALPHA_AT(string,offset)                                              \
189      (((string).pointer[offset] >= (yaml_char_t) '0' &&                         \
190        (string).pointer[offset] <= (yaml_char_t) '9') ||                        \
191       ((string).pointer[offset] >= (yaml_char_t) 'A' &&                         \
192        (string).pointer[offset] <= (yaml_char_t) 'Z') ||                        \
193       ((string).pointer[offset] >= (yaml_char_t) 'a' &&                         \
194        (string).pointer[offset] <= (yaml_char_t) 'z') ||                        \
195       (string).pointer[offset] == '_' ||                                        \
196       (string).pointer[offset] == '-')
197 
198 #define IS_ALPHA(string)    IS_ALPHA_AT((string),0)
199 
200 /*
201  * Check if the character at the specified position is a digit.
202  */
203 
204 #define IS_DIGIT_AT(string,offset)                                              \
205      (((string).pointer[offset] >= (yaml_char_t) '0' &&                         \
206        (string).pointer[offset] <= (yaml_char_t) '9'))
207 
208 #define IS_DIGIT(string)    IS_DIGIT_AT((string),0)
209 
210 /*
211  * Get the value of a digit.
212  */
213 
214 #define AS_DIGIT_AT(string,offset)                                              \
215      ((string).pointer[offset] - (yaml_char_t) '0')
216 
217 #define AS_DIGIT(string)    AS_DIGIT_AT((string),0)
218 
219 /*
220  * Check if the character at the specified position is a hex-digit.
221  */
222 
223 #define IS_HEX_AT(string,offset)                                                \
224      (((string).pointer[offset] >= (yaml_char_t) '0' &&                         \
225        (string).pointer[offset] <= (yaml_char_t) '9') ||                        \
226       ((string).pointer[offset] >= (yaml_char_t) 'A' &&                         \
227        (string).pointer[offset] <= (yaml_char_t) 'F') ||                        \
228       ((string).pointer[offset] >= (yaml_char_t) 'a' &&                         \
229        (string).pointer[offset] <= (yaml_char_t) 'f'))
230 
231 #define IS_HEX(string)    IS_HEX_AT((string),0)
232 
233 /*
234  * Get the value of a hex-digit.
235  */
236 
237 #define AS_HEX_AT(string,offset)                                                \
238       (((string).pointer[offset] >= (yaml_char_t) 'A' &&                        \
239         (string).pointer[offset] <= (yaml_char_t) 'F') ?                        \
240        ((string).pointer[offset] - (yaml_char_t) 'A' + 10) :                    \
241        ((string).pointer[offset] >= (yaml_char_t) 'a' &&                        \
242         (string).pointer[offset] <= (yaml_char_t) 'f') ?                        \
243        ((string).pointer[offset] - (yaml_char_t) 'a' + 10) :                    \
244        ((string).pointer[offset] - (yaml_char_t) '0'))
245 
246 #define AS_HEX(string)  AS_HEX_AT((string),0)
247 
248 /*
249  * Check if the character is ASCII.
250  */
251 
252 #define IS_ASCII_AT(string,offset)                                              \
253     ((string).pointer[offset] <= (yaml_char_t) '\x7F')
254 
255 #define IS_ASCII(string)    IS_ASCII_AT((string),0)
256 
257 /*
258  * Check if the character can be printed unescaped.
259  */
260 
261 #define IS_PRINTABLE_AT(string,offset)                                          \
262     (((string).pointer[offset] == 0x0A)         /* . == #x0A */                 \
263      || ((string).pointer[offset] >= 0x20       /* #x20 <= . <= #x7E */         \
264          && (string).pointer[offset] <= 0x7E)                                   \
265      || ((string).pointer[offset] == 0xC2       /* #0xA0 <= . <= #xD7FF */      \
266          && (string).pointer[offset+1] >= 0xA0)                                 \
267      || ((string).pointer[offset] > 0xC2                                        \
268          && (string).pointer[offset] < 0xED)                                    \
269      || ((string).pointer[offset] == 0xED                                       \
270          && (string).pointer[offset+1] < 0xA0)                                  \
271      || ((string).pointer[offset] == 0xEE)                                      \
272      || ((string).pointer[offset] == 0xEF      /* #xE000 <= . <= #xFFFD */      \
273          && !((string).pointer[offset+1] == 0xBB        /* && . != #xFEFF */    \
274              && (string).pointer[offset+2] == 0xBF)                             \
275          && !((string).pointer[offset+1] == 0xBF                                \
276              && ((string).pointer[offset+2] == 0xBE                             \
277                  || (string).pointer[offset+2] == 0xBF))))
278 
279 #define IS_PRINTABLE(string)    IS_PRINTABLE_AT((string),0)
280 
281 /*
282  * Check if the character at the specified position is NUL.
283  */
284 
285 #define IS_Z_AT(string,offset)    CHECK_AT((string),'\0',(offset))
286 
287 #define IS_Z(string)    IS_Z_AT((string),0)
288 
289 /*
290  * Check if the character at the specified position is BOM.
291  */
292 
293 #define IS_BOM_AT(string,offset)                                                \
294      (CHECK_AT((string),'\xEF',(offset))                                        \
295       && CHECK_AT((string),'\xBB',(offset)+1)                                   \
296       && CHECK_AT((string),'\xBF',(offset)+2))  /* BOM (#xFEFF) */
297 
298 #define IS_BOM(string)  IS_BOM_AT(string,0)
299 
300 /*
301  * Check if the character at the specified position is space.
302  */
303 
304 #define IS_SPACE_AT(string,offset)  CHECK_AT((string),' ',(offset))
305 
306 #define IS_SPACE(string)    IS_SPACE_AT((string),0)
307 
308 /*
309  * Check if the character at the specified position is tab.
310  */
311 
312 #define IS_TAB_AT(string,offset)    CHECK_AT((string),'\t',(offset))
313 
314 #define IS_TAB(string)  IS_TAB_AT((string),0)
315 
316 /*
317  * Check if the character at the specified position is blank (space or tab).
318  */
319 
320 #define IS_BLANK_AT(string,offset)                                              \
321     (IS_SPACE_AT((string),(offset)) || IS_TAB_AT((string),(offset)))
322 
323 #define IS_BLANK(string)    IS_BLANK_AT((string),0)
324 
325 /*
326  * Check if the character at the specified position is a line break.
327  */
328 
329 #define IS_BREAK_AT(string,offset)                                              \
330     (CHECK_AT((string),'\r',(offset))               /* CR (#xD)*/               \
331      || CHECK_AT((string),'\n',(offset))            /* LF (#xA) */              \
332      || (CHECK_AT((string),'\xC2',(offset))                                     \
333          && CHECK_AT((string),'\x85',(offset)+1))   /* NEL (#x85) */            \
334      || (CHECK_AT((string),'\xE2',(offset))                                     \
335          && CHECK_AT((string),'\x80',(offset)+1)                                \
336          && CHECK_AT((string),'\xA8',(offset)+2))   /* LS (#x2028) */           \
337      || (CHECK_AT((string),'\xE2',(offset))                                     \
338          && CHECK_AT((string),'\x80',(offset)+1)                                \
339          && CHECK_AT((string),'\xA9',(offset)+2)))  /* PS (#x2029) */
340 
341 #define IS_BREAK(string)    IS_BREAK_AT((string),0)
342 
343 #define IS_CRLF_AT(string,offset)                                               \
344      (CHECK_AT((string),'\r',(offset)) && CHECK_AT((string),'\n',(offset)+1))
345 
346 #define IS_CRLF(string) IS_CRLF_AT((string),0)
347 
348 /*
349  * Check if the character is a line break or NUL.
350  */
351 
352 #define IS_BREAKZ_AT(string,offset)                                             \
353     (IS_BREAK_AT((string),(offset)) || IS_Z_AT((string),(offset)))
354 
355 #define IS_BREAKZ(string)   IS_BREAKZ_AT((string),0)
356 
357 /*
358  * Check if the character is a line break, space, or NUL.
359  */
360 
361 #define IS_SPACEZ_AT(string,offset)                                             \
362     (IS_SPACE_AT((string),(offset)) || IS_BREAKZ_AT((string),(offset)))
363 
364 #define IS_SPACEZ(string)   IS_SPACEZ_AT((string),0)
365 
366 /*
367  * Check if the character is a line break, space, tab, or NUL.
368  */
369 
370 #define IS_BLANKZ_AT(string,offset)                                             \
371     (IS_BLANK_AT((string),(offset)) || IS_BREAKZ_AT((string),(offset)))
372 
373 #define IS_BLANKZ(string)   IS_BLANKZ_AT((string),0)
374 
375 /*
376  * Determine the width of the character.
377  */
378 
379 #define WIDTH_AT(string,offset)                                                 \
380      (((string).pointer[offset] & 0x80) == 0x00 ? 1 :                           \
381       ((string).pointer[offset] & 0xE0) == 0xC0 ? 2 :                           \
382       ((string).pointer[offset] & 0xF0) == 0xE0 ? 3 :                           \
383       ((string).pointer[offset] & 0xF8) == 0xF0 ? 4 : 0)
384 
385 #define WIDTH(string)   WIDTH_AT((string),0)
386 
387 /*
388  * Move the string pointer to the next character.
389  */
390 
391 #define MOVE(string)    ((string).pointer += WIDTH((string)))
392 
393 /*
394  * Copy a character and move the pointers of both strings.
395  */
396 
397 #define COPY(string_a,string_b)                                                 \
398     ((*(string_b).pointer & 0x80) == 0x00 ?                                     \
399      (*((string_a).pointer++) = *((string_b).pointer++)) :                      \
400      (*(string_b).pointer & 0xE0) == 0xC0 ?                                     \
401      (*((string_a).pointer++) = *((string_b).pointer++),                        \
402       *((string_a).pointer++) = *((string_b).pointer++)) :                      \
403      (*(string_b).pointer & 0xF0) == 0xE0 ?                                     \
404      (*((string_a).pointer++) = *((string_b).pointer++),                        \
405       *((string_a).pointer++) = *((string_b).pointer++),                        \
406       *((string_a).pointer++) = *((string_b).pointer++)) :                      \
407      (*(string_b).pointer & 0xF8) == 0xF0 ?                                     \
408      (*((string_a).pointer++) = *((string_b).pointer++),                        \
409       *((string_a).pointer++) = *((string_b).pointer++),                        \
410       *((string_a).pointer++) = *((string_b).pointer++),                        \
411       *((string_a).pointer++) = *((string_b).pointer++)) : 0)
412 
413 /*
414  * Stack and queue management.
415  */
416 
417 YAML_DECLARE(int)
418 yaml_stack_extend(void **start, void **top, void **end);
419 
420 YAML_DECLARE(int)
421 yaml_queue_extend(void **start, void **head, void **tail, void **end);
422 
423 #define STACK_INIT(context,stack,type)                                     \
424   (((stack).start = (type)yaml_malloc(INITIAL_STACK_SIZE*sizeof(*(stack).start))) ? \
425         ((stack).top = (stack).start,                                           \
426          (stack).end = (stack).start+INITIAL_STACK_SIZE,                        \
427          1) :                                                                   \
428         ((context)->error = YAML_MEMORY_ERROR,                                  \
429          0))
430 
431 #define STACK_DEL(context,stack)                                                \
432     (yaml_free((stack).start),                                                  \
433      (stack).start = (stack).top = (stack).end = 0)
434 
435 #define STACK_EMPTY(context,stack)                                              \
436     ((stack).start == (stack).top)
437 
438 #define STACK_LIMIT(context,stack,size)                                         \
439     ((stack).top - (stack).start < (size) ?                                     \
440         1 :                                                                     \
441         ((context)->error = YAML_MEMORY_ERROR,                                  \
442          0))
443 
444 #define PUSH(context,stack,value)                                               \
445     (((stack).top != (stack).end                                                \
446       || yaml_stack_extend((void **)&(stack).start,                             \
447               (void **)&(stack).top, (void **)&(stack).end)) ?                  \
448         (*((stack).top++) = value,                                              \
449          1) :                                                                   \
450         ((context)->error = YAML_MEMORY_ERROR,                                  \
451          0))
452 
453 #define POP(context,stack)                                                      \
454     (*(--(stack).top))
455 
456 #define QUEUE_INIT(context,queue,size,type)                                     \
457   (((queue).start = (type)yaml_malloc((size)*sizeof(*(queue).start))) ?         \
458         ((queue).head = (queue).tail = (queue).start,                           \
459          (queue).end = (queue).start+(size),                                    \
460          1) :                                                                   \
461         ((context)->error = YAML_MEMORY_ERROR,                                  \
462          0))
463 
464 #define QUEUE_DEL(context,queue)                                                \
465     (yaml_free((queue).start),                                                  \
466      (queue).start = (queue).head = (queue).tail = (queue).end = 0)
467 
468 #define QUEUE_EMPTY(context,queue)                                              \
469     ((queue).head == (queue).tail)
470 
471 #define ENQUEUE(context,queue,value)                                            \
472     (((queue).tail != (queue).end                                               \
473       || yaml_queue_extend((void **)&(queue).start, (void **)&(queue).head,     \
474             (void **)&(queue).tail, (void **)&(queue).end)) ?                   \
475         (*((queue).tail++) = value,                                             \
476          1) :                                                                   \
477         ((context)->error = YAML_MEMORY_ERROR,                                  \
478          0))
479 
480 #define DEQUEUE(context,queue)                                                  \
481     (*((queue).head++))
482 
483 #define QUEUE_INSERT(context,queue,index,value)                                 \
484     (((queue).tail != (queue).end                                               \
485       || yaml_queue_extend((void **)&(queue).start, (void **)&(queue).head,     \
486             (void **)&(queue).tail, (void **)&(queue).end)) ?                   \
487         (memmove((queue).head+(index)+1,(queue).head+(index),                   \
488             ((queue).tail-(queue).head-(index))*sizeof(*(queue).start)),        \
489          *((queue).head+(index)) = value,                                       \
490          (queue).tail++,                                                        \
491          1) :                                                                   \
492         ((context)->error = YAML_MEMORY_ERROR,                                  \
493          0))
494 
495 /*
496  * Token initializers.
497  */
498 
499 #define TOKEN_INIT(token,token_type,token_start_mark,token_end_mark)            \
500     (memset(&(token), 0, sizeof(yaml_token_t)),                                 \
501      (token).type = (token_type),                                               \
502      (token).start_mark = (token_start_mark),                                   \
503      (token).end_mark = (token_end_mark))
504 
505 #define STREAM_START_TOKEN_INIT(token,token_encoding,start_mark,end_mark)       \
506     (TOKEN_INIT((token),YAML_STREAM_START_TOKEN,(start_mark),(end_mark)),       \
507      (token).data.stream_start.encoding = (token_encoding))
508 
509 #define STREAM_END_TOKEN_INIT(token,start_mark,end_mark)                        \
510     (TOKEN_INIT((token),YAML_STREAM_END_TOKEN,(start_mark),(end_mark)))
511 
512 #define ALIAS_TOKEN_INIT(token,token_value,start_mark,end_mark)                 \
513     (TOKEN_INIT((token),YAML_ALIAS_TOKEN,(start_mark),(end_mark)),              \
514      (token).data.alias.value = (token_value))
515 
516 #define ANCHOR_TOKEN_INIT(token,token_value,start_mark,end_mark)                \
517     (TOKEN_INIT((token),YAML_ANCHOR_TOKEN,(start_mark),(end_mark)),             \
518      (token).data.anchor.value = (token_value))
519 
520 #define TAG_TOKEN_INIT(token,token_handle,token_suffix,start_mark,end_mark)     \
521     (TOKEN_INIT((token),YAML_TAG_TOKEN,(start_mark),(end_mark)),                \
522      (token).data.tag.handle = (token_handle),                                  \
523      (token).data.tag.suffix = (token_suffix))
524 
525 #define SCALAR_TOKEN_INIT(token,token_value,token_length,token_style,start_mark,end_mark)   \
526     (TOKEN_INIT((token),YAML_SCALAR_TOKEN,(start_mark),(end_mark)),             \
527      (token).data.scalar.value = (token_value),                                 \
528      (token).data.scalar.length = (token_length),                               \
529      (token).data.scalar.style = (token_style))
530 
531 #define VERSION_DIRECTIVE_TOKEN_INIT(token,token_major,token_minor,start_mark,end_mark)     \
532     (TOKEN_INIT((token),YAML_VERSION_DIRECTIVE_TOKEN,(start_mark),(end_mark)),  \
533      (token).data.version_directive.major = (token_major),                      \
534      (token).data.version_directive.minor = (token_minor))
535 
536 #define TAG_DIRECTIVE_TOKEN_INIT(token,token_handle,token_prefix,start_mark,end_mark)       \
537     (TOKEN_INIT((token),YAML_TAG_DIRECTIVE_TOKEN,(start_mark),(end_mark)),      \
538      (token).data.tag_directive.handle = (token_handle),                        \
539      (token).data.tag_directive.prefix = (token_prefix))
540 
541 /*
542  * Event initializers.
543  */
544 
545 #define EVENT_INIT(event,event_type,event_start_mark,event_end_mark)            \
546     (memset(&(event), 0, sizeof(yaml_event_t)),                                 \
547      (event).type = (event_type),                                               \
548      (event).start_mark = (event_start_mark),                                   \
549      (event).end_mark = (event_end_mark))
550 
551 #define STREAM_START_EVENT_INIT(event,event_encoding,start_mark,end_mark)       \
552     (EVENT_INIT((event),YAML_STREAM_START_EVENT,(start_mark),(end_mark)),       \
553      (event).data.stream_start.encoding = (event_encoding))
554 
555 #define STREAM_END_EVENT_INIT(event,start_mark,end_mark)                        \
556     (EVENT_INIT((event),YAML_STREAM_END_EVENT,(start_mark),(end_mark)))
557 
558 #define DOCUMENT_START_EVENT_INIT(event,event_version_directive,                \
559         event_tag_directives_start,event_tag_directives_end,event_implicit,start_mark,end_mark) \
560     (EVENT_INIT((event),YAML_DOCUMENT_START_EVENT,(start_mark),(end_mark)),     \
561      (event).data.document_start.version_directive = (event_version_directive), \
562      (event).data.document_start.tag_directives.start = (event_tag_directives_start),   \
563      (event).data.document_start.tag_directives.end = (event_tag_directives_end),   \
564      (event).data.document_start.implicit = (event_implicit))
565 
566 #define DOCUMENT_END_EVENT_INIT(event,event_implicit,start_mark,end_mark)       \
567     (EVENT_INIT((event),YAML_DOCUMENT_END_EVENT,(start_mark),(end_mark)),       \
568      (event).data.document_end.implicit = (event_implicit))
569 
570 #define ALIAS_EVENT_INIT(event,event_anchor,start_mark,end_mark)                \
571     (EVENT_INIT((event),YAML_ALIAS_EVENT,(start_mark),(end_mark)),              \
572      (event).data.alias.anchor = (event_anchor))
573 
574 #define SCALAR_EVENT_INIT(event,event_anchor,event_tag,event_value,event_length,    \
575         event_plain_implicit, event_quoted_implicit,event_style,start_mark,end_mark)    \
576     (EVENT_INIT((event),YAML_SCALAR_EVENT,(start_mark),(end_mark)),             \
577      (event).data.scalar.anchor = (event_anchor),                               \
578      (event).data.scalar.tag = (event_tag),                                     \
579      (event).data.scalar.value = (event_value),                                 \
580      (event).data.scalar.length = (event_length),                               \
581      (event).data.scalar.plain_implicit = (event_plain_implicit),               \
582      (event).data.scalar.quoted_implicit = (event_quoted_implicit),             \
583      (event).data.scalar.style = (event_style))
584 
585 #define SEQUENCE_START_EVENT_INIT(event,event_anchor,event_tag,                 \
586         event_implicit,event_style,start_mark,end_mark)                         \
587     (EVENT_INIT((event),YAML_SEQUENCE_START_EVENT,(start_mark),(end_mark)),     \
588      (event).data.sequence_start.anchor = (event_anchor),                       \
589      (event).data.sequence_start.tag = (event_tag),                             \
590      (event).data.sequence_start.implicit = (event_implicit),                   \
591      (event).data.sequence_start.style = (event_style))
592 
593 #define SEQUENCE_END_EVENT_INIT(event,start_mark,end_mark)                      \
594     (EVENT_INIT((event),YAML_SEQUENCE_END_EVENT,(start_mark),(end_mark)))
595 
596 #define MAPPING_START_EVENT_INIT(event,event_anchor,event_tag,                  \
597         event_implicit,event_style,start_mark,end_mark)                         \
598     (EVENT_INIT((event),YAML_MAPPING_START_EVENT,(start_mark),(end_mark)),      \
599      (event).data.mapping_start.anchor = (event_anchor),                        \
600      (event).data.mapping_start.tag = (event_tag),                              \
601      (event).data.mapping_start.implicit = (event_implicit),                    \
602      (event).data.mapping_start.style = (event_style))
603 
604 #define MAPPING_END_EVENT_INIT(event,start_mark,end_mark)                       \
605     (EVENT_INIT((event),YAML_MAPPING_END_EVENT,(start_mark),(end_mark)))
606 
607 /*
608  * Document initializer.
609  */
610 
611 #define DOCUMENT_INIT(document,document_nodes_start,document_nodes_end,         \
612         document_version_directive,document_tag_directives_start,               \
613         document_tag_directives_end,document_start_implicit,                    \
614         document_end_implicit,document_start_mark,document_end_mark)            \
615     (memset(&(document), 0, sizeof(yaml_document_t)),                           \
616      (document).nodes.start = (document_nodes_start),                           \
617      (document).nodes.end = (document_nodes_end),                               \
618      (document).nodes.top = (document_nodes_start),                             \
619      (document).version_directive = (document_version_directive),               \
620      (document).tag_directives.start = (document_tag_directives_start),         \
621      (document).tag_directives.end = (document_tag_directives_end),             \
622      (document).start_implicit = (document_start_implicit),                     \
623      (document).end_implicit = (document_end_implicit),                         \
624      (document).start_mark = (document_start_mark),                             \
625      (document).end_mark = (document_end_mark))
626 
627 /*
628  * Node initializers.
629  */
630 
631 #define NODE_INIT(node,node_type,node_tag,node_start_mark,node_end_mark)        \
632     (memset(&(node), 0, sizeof(yaml_node_t)),                                   \
633      (node).type = (node_type),                                                 \
634      (node).tag = (node_tag),                                                   \
635      (node).start_mark = (node_start_mark),                                     \
636      (node).end_mark = (node_end_mark))
637 
638 #define SCALAR_NODE_INIT(node,node_tag,node_value,node_length,                  \
639         node_style,start_mark,end_mark)                                         \
640     (NODE_INIT((node),YAML_SCALAR_NODE,(node_tag),(start_mark),(end_mark)),     \
641      (node).data.scalar.value = (node_value),                                   \
642      (node).data.scalar.length = (node_length),                                 \
643      (node).data.scalar.style = (node_style))
644 
645 #define SEQUENCE_NODE_INIT(node,node_tag,node_items_start,node_items_end,       \
646         node_style,start_mark,end_mark)                                         \
647     (NODE_INIT((node),YAML_SEQUENCE_NODE,(node_tag),(start_mark),(end_mark)),   \
648      (node).data.sequence.items.start = (node_items_start),                     \
649      (node).data.sequence.items.end = (node_items_end),                         \
650      (node).data.sequence.items.top = (node_items_start),                       \
651      (node).data.sequence.style = (node_style))
652 
653 #define MAPPING_NODE_INIT(node,node_tag,node_pairs_start,node_pairs_end,        \
654         node_style,start_mark,end_mark)                                         \
655     (NODE_INIT((node),YAML_MAPPING_NODE,(node_tag),(start_mark),(end_mark)),    \
656      (node).data.mapping.pairs.start = (node_pairs_start),                      \
657      (node).data.mapping.pairs.end = (node_pairs_end),                          \
658      (node).data.mapping.pairs.top = (node_pairs_start),                        \
659      (node).data.mapping.style = (node_style))
660 
661 /* Strict C compiler warning helpers */
662 
663 #if defined(__clang__) || defined(__GNUC__)
664 #  define HASATTRIBUTE_UNUSED
665 #endif
666 #ifdef HASATTRIBUTE_UNUSED
667 #  define __attribute__unused__             __attribute__((__unused__))
668 #else
669 #  define __attribute__unused__
670 #endif
671 
672 /* Shim arguments are arguments that must be included in your function,
673  * but serve no purpose inside.  Silence compiler warnings. */
674 #define SHIM(a) /*@unused@*/ a __attribute__unused__
675 
676 /* UNUSED_PARAM() marks a shim argument in the body to silence compiler warnings */
677 #ifdef __clang__
678 #  define UNUSED_PARAM(a) (void)(a);
679 #else
680 #  define UNUSED_PARAM(a) /*@-noeffect*/if (0) (void)(a)/*@=noeffect*/;
681 #endif
682 
683 #define YAML_MALLOC_STATIC(type) (type*)yaml_malloc(sizeof(type))
684 #define YAML_MALLOC(size)        (yaml_char_t *)yaml_malloc(size)
685