on de41665 help sign in
3576 lines 98 kB history raw
2/*
3 * Introduction
4 * ************
5 *
6 * The following notes assume that you are familiar with the YAML specification
7 * (http://yaml.org/spec/cvs/current.html). We mostly follow it, although in
8 * some cases we are less restrictive that it requires.
9 *
10 * The process of transforming a YAML stream into a sequence of events is
11 * divided on two steps: Scanning and Parsing.
12 *
13 * The Scanner transforms the input stream into a sequence of tokens, while the
14 * parser transform the sequence of tokens produced by the Scanner into a
15 * sequence of parsing events.
16 *
17 * The Scanner is rather clever and complicated. The Parser, on the contrary,
18 * is a straightforward implementation of a recursive-descendant parser (or,
19 * LL(1) parser, as it is usually called).
20 *
21 * Actually there are two issues of Scanning that might be called "clever", the
22 * rest is quite straightforward. The issues are "block collection start" and
23 * "simple keys". Both issues are explained below in details.
24 *
25 * Here the Scanning step is explained and implemented. We start with the list
26 * of all the tokens produced by the Scanner together with short descriptions.
27 *
28 * Now, tokens:
29 *
30 * STREAM-START(encoding) # The stream start.
31 * STREAM-END # The stream end.
32 * VERSION-DIRECTIVE(major,minor) # The '%YAML' directive.
33 * TAG-DIRECTIVE(handle,prefix) # The '%TAG' directive.
34 * DOCUMENT-START # '---'
35 * DOCUMENT-END # '...'
36 * BLOCK-SEQUENCE-START # Indentation increase denoting a block
37 * BLOCK-MAPPING-START # sequence or a block mapping.
38 * BLOCK-END # Indentation decrease.
39 * FLOW-SEQUENCE-START # '['
40 * FLOW-SEQUENCE-END # ']'
41 * BLOCK-SEQUENCE-START # '{'
42 * BLOCK-SEQUENCE-END # '}'
43 * BLOCK-ENTRY # '-'
44 * FLOW-ENTRY # ','
45 * KEY # '?' or nothing (simple keys).
46 * VALUE # ':'
47 * ALIAS(anchor) # '*anchor'
48 * ANCHOR(anchor) # '&anchor'
49 * TAG(handle,suffix) # '!handle!suffix'
50 * SCALAR(value,style) # A scalar.
51 *
52 * The following two tokens are "virtual" tokens denoting the beginning and the
53 * end of the stream:
54 *
55 * STREAM-START(encoding)
56 * STREAM-END
57 *
58 * We pass the information about the input stream encoding with the
59 * STREAM-START token.
60 *
61 * The next two tokens are responsible for tags:
62 *
63 * VERSION-DIRECTIVE(major,minor)
64 * TAG-DIRECTIVE(handle,prefix)
65 *
66 * Example:
67 *
68 * %YAML 1.1
69 * %TAG ! !foo
70 * %TAG !yaml! tag:yaml.org,2002:
71 * ---
72 *
73 * The correspoding sequence of tokens:
74 *
75 * STREAM-START(utf-8)
76 * VERSION-DIRECTIVE(1,1)
77 * TAG-DIRECTIVE("!","!foo")
78 * TAG-DIRECTIVE("!yaml","tag:yaml.org,2002:")
79 * DOCUMENT-START
80 * STREAM-END
81 *
82 * Note that the VERSION-DIRECTIVE and TAG-DIRECTIVE tokens occupy a whole
83 * line.
84 *
85 * The document start and end indicators are represented by:
86 *
87 * DOCUMENT-START
88 * DOCUMENT-END
89 *
90 * Note that if a YAML stream contains an implicit document (without '---'
91 * and '...' indicators), no DOCUMENT-START and DOCUMENT-END tokens will be
92 * produced.
93 *
94 * In the following examples, we present whole documents together with the
95 * produced tokens.
96 *
97 * 1. An implicit document:
98 *
99 * 'a scalar'
100 *
101 * Tokens:
102 *
103 * STREAM-START(utf-8)
104 * SCALAR("a scalar",single-quoted)
105 * STREAM-END
106 *
107 * 2. An explicit document:
108 *
109 * ---
110 * 'a scalar'
111 * ...
112 *
113 * Tokens:
114 *
115 * STREAM-START(utf-8)
116 * DOCUMENT-START
117 * SCALAR("a scalar",single-quoted)
118 * DOCUMENT-END
119 * STREAM-END
120 *
121 * 3. Several documents in a stream:
122 *
123 * 'a scalar'
124 * ---
125 * 'another scalar'
126 * ---
127 * 'yet another scalar'
128 *
129 * Tokens:
130 *
131 * STREAM-START(utf-8)
132 * SCALAR("a scalar",single-quoted)
133 * DOCUMENT-START
134 * SCALAR("another scalar",single-quoted)
135 * DOCUMENT-START
136 * SCALAR("yet another scalar",single-quoted)
137 * STREAM-END
138 *
139 * We have already introduced the SCALAR token above. The following tokens are
140 * used to describe aliases, anchors, tag, and scalars:
141 *
142 * ALIAS(anchor)
143 * ANCHOR(anchor)
144 * TAG(handle,suffix)
145 * SCALAR(value,style)
146 *
147 * The following series of examples illustrate the usage of these tokens:
148 *
149 * 1. A recursive sequence:
150 *
151 * &A [ *A ]
152 *
153 * Tokens:
154 *
155 * STREAM-START(utf-8)
156 * ANCHOR("A")
157 * FLOW-SEQUENCE-START
158 * ALIAS("A")
159 * FLOW-SEQUENCE-END
160 * STREAM-END
161 *
162 * 2. A tagged scalar:
163 *
164 * !!float "3.14" # A good approximation.
165 *
166 * Tokens:
167 *
168 * STREAM-START(utf-8)
169 * TAG("!!","float")
170 * SCALAR("3.14",double-quoted)
171 * STREAM-END
172 *
173 * 3. Various scalar styles:
174 *
175 * --- # Implicit empty plain scalars do not produce tokens.
176 * --- a plain scalar
177 * --- 'a single-quoted scalar'
178 * --- "a double-quoted scalar"
179 * --- |-
180 * a literal scalar
181 * --- >-
182 * a folded
183 * scalar
184 *
185 * Tokens:
186 *
187 * STREAM-START(utf-8)
188 * DOCUMENT-START
189 * DOCUMENT-START
190 * SCALAR("a plain scalar",plain)
191 * DOCUMENT-START
192 * SCALAR("a single-quoted scalar",single-quoted)
193 * DOCUMENT-START
194 * SCALAR("a double-quoted scalar",double-quoted)
195 * DOCUMENT-START
196 * SCALAR("a literal scalar",literal)
197 * DOCUMENT-START
198 * SCALAR("a folded scalar",folded)
199 * STREAM-END
200 *
201 * Now it's time to review collection-related tokens. We will start with
202 * flow collections:
203 *
204 * FLOW-SEQUENCE-START
205 * FLOW-SEQUENCE-END
206 * FLOW-MAPPING-START
207 * FLOW-MAPPING-END
208 * FLOW-ENTRY
209 * KEY
210 * VALUE
211 *
212 * The tokens FLOW-SEQUENCE-START, FLOW-SEQUENCE-END, FLOW-MAPPING-START, and
213 * FLOW-MAPPING-END represent the indicators '[', ']', '{', and '}'
214 * correspondingly. FLOW-ENTRY represent the ',' indicator. Finally the
215 * indicators '?' and ':', which are used for denoting mapping keys and values,
216 * are represented by the KEY and VALUE tokens.
217 *
218 * The following examples show flow collections:
219 *
220 * 1. A flow sequence:
221 *
222 * [item 1, item 2, item 3]
223 *
224 * Tokens:
225 *
226 * STREAM-START(utf-8)
227 * FLOW-SEQUENCE-START
228 * SCALAR("item 1",plain)
229 * FLOW-ENTRY
230 * SCALAR("item 2",plain)
231 * FLOW-ENTRY
232 * SCALAR("item 3",plain)
233 * FLOW-SEQUENCE-END
234 * STREAM-END
235 *
236 * 2. A flow mapping:
237 *
238 * {
239 * a simple key: a value, # Note that the KEY token is produced.
240 * ? a complex key: another value,
241 * }
242 *
243 * Tokens:
244 *
245 * STREAM-START(utf-8)
246 * FLOW-MAPPING-START
247 * KEY
248 * SCALAR("a simple key",plain)
249 * VALUE
250 * SCALAR("a value",plain)
251 * FLOW-ENTRY
252 * KEY
253 * SCALAR("a complex key",plain)
254 * VALUE
255 * SCALAR("another value",plain)
256 * FLOW-ENTRY
257 * FLOW-MAPPING-END
258 * STREAM-END
259 *
260 * A simple key is a key which is not denoted by the '?' indicator. Note that
261 * the Scanner still produce the KEY token whenever it encounters a simple key.
262 *
263 * For scanning block collections, the following tokens are used (note that we
264 * repeat KEY and VALUE here):
265 *
266 * BLOCK-SEQUENCE-START
267 * BLOCK-MAPPING-START
268 * BLOCK-END
269 * BLOCK-ENTRY
270 * KEY
271 * VALUE
272 *
273 * The tokens BLOCK-SEQUENCE-START and BLOCK-MAPPING-START denote indentation
274 * increase that precedes a block collection (cf. the INDENT token in Python).
275 * The token BLOCK-END denote indentation decrease that ends a block collection
276 * (cf. the DEDENT token in Python). However YAML has some syntax pecularities
277 * that makes detections of these tokens more complex.
278 *
279 * The tokens BLOCK-ENTRY, KEY, and VALUE are used to represent the indicators
280 * '-', '?', and ':' correspondingly.
281 *
282 * The following examples show how the tokens BLOCK-SEQUENCE-START,
283 * BLOCK-MAPPING-START, and BLOCK-END are emitted by the Scanner:
284 *
285 * 1. Block sequences:
286 *
287 * - item 1
288 * - item 2
289 * -
290 * - item 3.1
291 * - item 3.2
292 * -
293 * key 1: value 1
294 * key 2: value 2
295 *
296 * Tokens:
297 *
298 * STREAM-START(utf-8)
299 * BLOCK-SEQUENCE-START
300 * BLOCK-ENTRY
301 * SCALAR("item 1",plain)
302 * BLOCK-ENTRY
303 * SCALAR("item 2",plain)
304 * BLOCK-ENTRY
305 * BLOCK-SEQUENCE-START
306 * BLOCK-ENTRY
307 * SCALAR("item 3.1",plain)
308 * BLOCK-ENTRY
309 * SCALAR("item 3.2",plain)
310 * BLOCK-END
311 * BLOCK-ENTRY
312 * BLOCK-MAPPING-START
313 * KEY
314 * SCALAR("key 1",plain)
315 * VALUE
316 * SCALAR("value 1",plain)
317 * KEY
318 * SCALAR("key 2",plain)
319 * VALUE
320 * SCALAR("value 2",plain)
321 * BLOCK-END
322 * BLOCK-END
323 * STREAM-END
324 *
325 * 2. Block mappings:
326 *
327 * a simple key: a value # The KEY token is produced here.
328 * ? a complex key
329 * : another value
330 * a mapping:
331 * key 1: value 1
332 * key 2: value 2
333 * a sequence:
334 * - item 1
335 * - item 2
336 *
337 * Tokens:
338 *
339 * STREAM-START(utf-8)
340 * BLOCK-MAPPING-START
341 * KEY
342 * SCALAR("a simple key",plain)
343 * VALUE
344 * SCALAR("a value",plain)
345 * KEY
346 * SCALAR("a complex key",plain)
347 * VALUE
348 * SCALAR("another value",plain)
349 * KEY
350 * SCALAR("a mapping",plain)
351 * BLOCK-MAPPING-START
352 * KEY
353 * SCALAR("key 1",plain)
354 * VALUE
355 * SCALAR("value 1",plain)
356 * KEY
357 * SCALAR("key 2",plain)
358 * VALUE
359 * SCALAR("value 2",plain)
360 * BLOCK-END
361 * KEY
362 * SCALAR("a sequence",plain)
363 * VALUE
364 * BLOCK-SEQUENCE-START
365 * BLOCK-ENTRY
366 * SCALAR("item 1",plain)
367 * BLOCK-ENTRY
368 * SCALAR("item 2",plain)
369 * BLOCK-END
370 * BLOCK-END
371 * STREAM-END
372 *
373 * YAML does not always require to start a new block collection from a new
374 * line. If the current line contains only '-', '?', and ':' indicators, a new
375 * block collection may start at the current line. The following examples
376 * illustrate this case:
377 *
378 * 1. Collections in a sequence:
379 *
380 * - - item 1
381 * - item 2
382 * - key 1: value 1
383 * key 2: value 2
384 * - ? complex key
385 * : complex value
386 *
387 * Tokens:
388 *
389 * STREAM-START(utf-8)
390 * BLOCK-SEQUENCE-START
391 * BLOCK-ENTRY
392 * BLOCK-SEQUENCE-START
393 * BLOCK-ENTRY
394 * SCALAR("item 1",plain)
395 * BLOCK-ENTRY
396 * SCALAR("item 2",plain)
397 * BLOCK-END
398 * BLOCK-ENTRY
399 * BLOCK-MAPPING-START
400 * KEY
401 * SCALAR("key 1",plain)
402 * VALUE
403 * SCALAR("value 1",plain)
404 * KEY
405 * SCALAR("key 2",plain)
406 * VALUE
407 * SCALAR("value 2",plain)
408 * BLOCK-END
409 * BLOCK-ENTRY
410 * BLOCK-MAPPING-START
411 * KEY
412 * SCALAR("complex key")
413 * VALUE
414 * SCALAR("complex value")
415 * BLOCK-END
416 * BLOCK-END
417 * STREAM-END
418 *
419 * 2. Collections in a mapping:
420 *
421 * ? a sequence
422 * : - item 1
423 * - item 2
424 * ? a mapping
425 * : key 1: value 1
426 * key 2: value 2
427 *
428 * Tokens:
429 *
430 * STREAM-START(utf-8)
431 * BLOCK-MAPPING-START
432 * KEY
433 * SCALAR("a sequence",plain)
434 * VALUE
435 * BLOCK-SEQUENCE-START
436 * BLOCK-ENTRY
437 * SCALAR("item 1",plain)
438 * BLOCK-ENTRY
439 * SCALAR("item 2",plain)
440 * BLOCK-END
441 * KEY
442 * SCALAR("a mapping",plain)
443 * VALUE
444 * BLOCK-MAPPING-START
445 * KEY
446 * SCALAR("key 1",plain)
447 * VALUE
448 * SCALAR("value 1",plain)
449 * KEY
450 * SCALAR("key 2",plain)
451 * VALUE
452 * SCALAR("value 2",plain)
453 * BLOCK-END
454 * BLOCK-END
455 * STREAM-END
456 *
457 * YAML also permits non-indented sequences if they are included into a block
458 * mapping. In this case, the token BLOCK-SEQUENCE-START is not produced:
459 *
460 * key:
461 * - item 1 # BLOCK-SEQUENCE-START is NOT produced here.
462 * - item 2
463 *
464 * Tokens:
465 *
466 * STREAM-START(utf-8)
467 * BLOCK-MAPPING-START
468 * KEY
469 * SCALAR("key",plain)
470 * VALUE
471 * BLOCK-ENTRY
472 * SCALAR("item 1",plain)
473 * BLOCK-ENTRY
474 * SCALAR("item 2",plain)
475 * BLOCK-END
476 */
478#include "yaml_private.h"
480/*
481 * Ensure that the buffer contains the required number of characters.
482 * Return 1 on success, 0 on failure (reader error or memory error).
483 */
485#define CACHE(parser,length) \
486 (parser->unread >= (length) \
487 ? 1 \
488 : yaml_parser_update_buffer(parser, (length)))
490/*
491 * Advance the buffer pointer.
492 */
494#define SKIP(parser) \
495 (parser->mark.index ++, \
496 parser->mark.column ++, \
497 parser->unread --, \
498 parser->buffer.pointer += WIDTH(parser->buffer))
500#define SKIP_LINE(parser) \
501 (IS_CRLF(parser->buffer) ? \
502 (parser->mark.index += 2, \
503 parser->mark.column = 0, \
504 parser->mark.line ++, \
505 parser->unread -= 2, \
506 parser->buffer.pointer += 2) : \
507 IS_BREAK(parser->buffer) ? \
508 (parser->mark.index ++, \
509 parser->mark.column = 0, \
510 parser->mark.line ++, \
511 parser->unread --, \
512 parser->buffer.pointer += WIDTH(parser->buffer)) : 0)
514/*
515 * Copy a character to a string buffer and advance pointers.
516 */
518#define READ(parser,string) \
519 (STRING_EXTEND(parser,string) ? \
520 (COPY(string,parser->buffer), \
521 parser->mark.index ++, \
522 parser->mark.column ++, \
523 parser->unread --, \
524 1) : 0)
526/*
527 * Copy a line break character to a string buffer and advance pointers.
528 */
530#define READ_LINE(parser,string) \
531 (STRING_EXTEND(parser,string) ? \
532 (((CHECK_AT(parser->buffer,'\r',0) \
533 && CHECK_AT(parser->buffer,'\n',1)) ? /* CR LF -> LF */ \
534 (*((string).pointer++) = (yaml_char_t) '\n', \
535 parser->buffer.pointer += 2, \
536 parser->mark.index += 2, \
537 parser->mark.column = 0, \
538 parser->mark.line ++, \
539 parser->unread -= 2) : \
540 (CHECK_AT(parser->buffer,'\r',0) \
541 || CHECK_AT(parser->buffer,'\n',0)) ? /* CR|LF -> LF */ \
542 (*((string).pointer++) = (yaml_char_t) '\n', \
543 parser->buffer.pointer ++, \
544 parser->mark.index ++, \
545 parser->mark.column = 0, \
546 parser->mark.line ++, \
547 parser->unread --) : \
548 (CHECK_AT(parser->buffer,'\xC2',0) \
549 && CHECK_AT(parser->buffer,'\x85',1)) ? /* NEL -> LF */ \
550 (*((string).pointer++) = (yaml_char_t) '\n', \
551 parser->buffer.pointer += 2, \
552 parser->mark.index ++, \
553 parser->mark.column = 0, \
554 parser->mark.line ++, \
555 parser->unread --) : \
556 (CHECK_AT(parser->buffer,'\xE2',0) && \
557 CHECK_AT(parser->buffer,'\x80',1) && \
558 (CHECK_AT(parser->buffer,'\xA8',2) || \
559 CHECK_AT(parser->buffer,'\xA9',2))) ? /* LS|PS -> LS|PS */ \
560 (*((string).pointer++) = *(parser->buffer.pointer++), \
561 *((string).pointer++) = *(parser->buffer.pointer++), \
562 *((string).pointer++) = *(parser->buffer.pointer++), \
563 parser->mark.index ++, \
564 parser->mark.column = 0, \
565 parser->mark.line ++, \
566 parser->unread --) : 0), \
567 1) : 0)
569/*
570 * Public API declarations.
571 */
573YAML_DECLARE(int)
574yaml_parser_scan(yaml_parser_t *parser, yaml_token_t *token);
576/*
577 * Error handling.
578 */
580static int
581yaml_parser_set_scanner_error(yaml_parser_t *parser, const char *context,
582 yaml_mark_t context_mark, const char *problem);
584/*
585 * High-level token API.
586 */
588YAML_DECLARE(int)
589yaml_parser_fetch_more_tokens(yaml_parser_t *parser);
591static int
592yaml_parser_fetch_next_token(yaml_parser_t *parser);
594/*
595 * Potential simple keys.
596 */
598static int
599yaml_parser_stale_simple_keys(yaml_parser_t *parser);
601static int
602yaml_parser_save_simple_key(yaml_parser_t *parser);
604static int
605yaml_parser_remove_simple_key(yaml_parser_t *parser);
607static int
608yaml_parser_increase_flow_level(yaml_parser_t *parser);
610static int
611yaml_parser_decrease_flow_level(yaml_parser_t *parser);
613/*
614 * Indentation treatment.
615 */
617static int
618yaml_parser_roll_indent(yaml_parser_t *parser, ptrdiff_t column,
619 ptrdiff_t number, yaml_token_type_t type, yaml_mark_t mark);
621static int
622yaml_parser_unroll_indent(yaml_parser_t *parser, ptrdiff_t column);
624/*
625 * Token fetchers.
626 */
628static int
629yaml_parser_fetch_stream_start(yaml_parser_t *parser);
631static int
632yaml_parser_fetch_stream_end(yaml_parser_t *parser);
634static int
635yaml_parser_fetch_directive(yaml_parser_t *parser);
637static int
638yaml_parser_fetch_document_indicator(yaml_parser_t *parser,
639 yaml_token_type_t type);
641static int
642yaml_parser_fetch_flow_collection_start(yaml_parser_t *parser,
643 yaml_token_type_t type);
645static int
646yaml_parser_fetch_flow_collection_end(yaml_parser_t *parser,
647 yaml_token_type_t type);
649static int
650yaml_parser_fetch_flow_entry(yaml_parser_t *parser);
652static int
653yaml_parser_fetch_block_entry(yaml_parser_t *parser);
655static int
656yaml_parser_fetch_key(yaml_parser_t *parser);
658static int
659yaml_parser_fetch_value(yaml_parser_t *parser);
661static int
662yaml_parser_fetch_anchor(yaml_parser_t *parser, yaml_token_type_t type);
664static int
665yaml_parser_fetch_tag(yaml_parser_t *parser);
667static int
668yaml_parser_fetch_block_scalar(yaml_parser_t *parser, int literal);
670static int
671yaml_parser_fetch_flow_scalar(yaml_parser_t *parser, int single);
673static int
674yaml_parser_fetch_plain_scalar(yaml_parser_t *parser);
676/*
677 * Token scanners.
678 */
680static int
681yaml_parser_scan_to_next_token(yaml_parser_t *parser);
683static int
684yaml_parser_scan_directive(yaml_parser_t *parser, yaml_token_t *token);
686static int
687yaml_parser_scan_directive_name(yaml_parser_t *parser,
688 yaml_mark_t start_mark, yaml_char_t **name);
690static int
691yaml_parser_scan_version_directive_value(yaml_parser_t *parser,
692 yaml_mark_t start_mark, int *major, int *minor);
694static int
695yaml_parser_scan_version_directive_number(yaml_parser_t *parser,
696 yaml_mark_t start_mark, int *number);
698static int
699yaml_parser_scan_tag_directive_value(yaml_parser_t *parser,
700 yaml_mark_t mark, yaml_char_t **handle, yaml_char_t **prefix);
702static int
703yaml_parser_scan_anchor(yaml_parser_t *parser, yaml_token_t *token,
704 yaml_token_type_t type);
706static int
707yaml_parser_scan_tag(yaml_parser_t *parser, yaml_token_t *token);
709static int
710yaml_parser_scan_tag_handle(yaml_parser_t *parser, int directive,
711 yaml_mark_t start_mark, yaml_char_t **handle);
713static int
714yaml_parser_scan_tag_uri(yaml_parser_t *parser, int directive,
715 yaml_char_t *head, yaml_mark_t start_mark, yaml_char_t **uri);
717static int
718yaml_parser_scan_uri_escapes(yaml_parser_t *parser, int directive,
719 yaml_mark_t start_mark, yaml_string_t *string);
721static int
722yaml_parser_scan_block_scalar(yaml_parser_t *parser, yaml_token_t *token,
723 int literal);
725static int
726yaml_parser_scan_block_scalar_breaks(yaml_parser_t *parser,
727 int *indent, yaml_string_t *breaks,
728 yaml_mark_t start_mark, yaml_mark_t *end_mark);
730static int
731yaml_parser_scan_flow_scalar(yaml_parser_t *parser, yaml_token_t *token,
732 int single);
734static int
735yaml_parser_scan_plain_scalar(yaml_parser_t *parser, yaml_token_t *token);
737/*
738 * Get the next token.
739 */
741YAML_DECLARE(int)
742yaml_parser_scan(yaml_parser_t *parser, yaml_token_t *token)
744 assert(parser); /* Non-NULL parser object is expected. */
745 assert(token); /* Non-NULL token object is expected. */
747 /* Erase the token object. */
749 memset(token, 0, sizeof(yaml_token_t));
751 /* No tokens after STREAM-END or error. */
753 if (parser->stream_end_produced || parser->error) {
754 return 1;
755 }
757 /* Ensure that the tokens queue contains enough tokens. */
759 if (!parser->token_available) {
760 if (!yaml_parser_fetch_more_tokens(parser))
761 return 0;
762 }
764 /* Fetch the next token from the queue. */
766 *token = DEQUEUE(parser, parser->tokens);
767 parser->token_available = 0;
768 parser->tokens_parsed ++;
770 if (token->type == YAML_STREAM_END_TOKEN) {
771 parser->stream_end_produced = 1;
772 }
774 return 1;
777/*
778 * Set the scanner error and return 0.
779 */
781static int
782yaml_parser_set_scanner_error(yaml_parser_t *parser, const char *context,
783 yaml_mark_t context_mark, const char *problem)
785 parser->error = YAML_SCANNER_ERROR;
786 parser->context = context;
787 parser->context_mark = context_mark;
788 parser->problem = problem;
789 parser->problem_mark = parser->mark;
791 return 0;
794/*
795 * Ensure that the tokens queue contains at least one token which can be
796 * returned to the Parser.
797 */
799YAML_DECLARE(int)
800yaml_parser_fetch_more_tokens(yaml_parser_t *parser)
802 int need_more_tokens;
804 /* While we need more tokens to fetch, do it. */
806 while (1)
807 {
808 /*
809 * Check if we really need to fetch more tokens.
810 */
812 need_more_tokens = 0;
814 if (parser->tokens.head == parser->tokens.tail)
815 {
816 /* Queue is empty. */
818 need_more_tokens = 1;
819 }
820 else
821 {
822 yaml_simple_key_t *simple_key;
824 /* Check if any potential simple key may occupy the head position. */
826 if (!yaml_parser_stale_simple_keys(parser))
827 return 0;
829 for (simple_key = parser->simple_keys.start;
830 simple_key != parser->simple_keys.top; simple_key++) {
831 if (simple_key->possible
832 && simple_key->token_number == parser->tokens_parsed) {
833 need_more_tokens = 1;
834 break;
835 }
836 }
837 }
839 /* We are finished. */
841 if (!need_more_tokens)
842 break;
844 /* Fetch the next token. */
846 if (!yaml_parser_fetch_next_token(parser))
847 return 0;
848 }
850 parser->token_available = 1;
852 return 1;
855/*
856 * The dispatcher for token fetchers.
857 */
859static int
860yaml_parser_fetch_next_token(yaml_parser_t *parser)
862 /* Ensure that the buffer is initialized. */
864 if (!CACHE(parser, 1))
865 return 0;
867 /* Check if we just started scanning. Fetch STREAM-START then. */
869 if (!parser->stream_start_produced)
870 return yaml_parser_fetch_stream_start(parser);
872 /* Eat whitespaces and comments until we reach the next token. */
874 if (!yaml_parser_scan_to_next_token(parser))
875 return 0;
877 /* Remove obsolete potential simple keys. */
879 if (!yaml_parser_stale_simple_keys(parser))
880 return 0;
882 /* Check the indentation level against the current column. */
884 if (!yaml_parser_unroll_indent(parser, parser->mark.column))
885 return 0;
887 /*
888 * Ensure that the buffer contains at least 4 characters. 4 is the length
889 * of the longest indicators ('--- ' and '... ').
890 */
892 if (!CACHE(parser, 4))
893 return 0;
895 /* Is it the end of the stream? */
897 if (IS_Z(parser->buffer))
898 return yaml_parser_fetch_stream_end(parser);
900 /* Is it a directive? */
902 if (parser->mark.column == 0 && CHECK(parser->buffer, '%'))
903 return yaml_parser_fetch_directive(parser);
905 /* Is it the document start indicator? */
907 if (parser->mark.column == 0
908 && CHECK_AT(parser->buffer, '-', 0)
909 && CHECK_AT(parser->buffer, '-', 1)
910 && CHECK_AT(parser->buffer, '-', 2)
911 && IS_BLANKZ_AT(parser->buffer, 3))
912 return yaml_parser_fetch_document_indicator(parser,
913 YAML_DOCUMENT_START_TOKEN);
915 /* Is it the document end indicator? */
917 if (parser->mark.column == 0
918 && CHECK_AT(parser->buffer, '.', 0)
919 && CHECK_AT(parser->buffer, '.', 1)
920 && CHECK_AT(parser->buffer, '.', 2)
921 && IS_BLANKZ_AT(parser->buffer, 3))
922 return yaml_parser_fetch_document_indicator(parser,
923 YAML_DOCUMENT_END_TOKEN);
925 /* Is it the flow sequence start indicator? */
927 if (CHECK(parser->buffer, '['))
928 return yaml_parser_fetch_flow_collection_start(parser,
929 YAML_FLOW_SEQUENCE_START_TOKEN);
931 /* Is it the flow mapping start indicator? */
933 if (CHECK(parser->buffer, '{'))
934 return yaml_parser_fetch_flow_collection_start(parser,
935 YAML_FLOW_MAPPING_START_TOKEN);
937 /* Is it the flow sequence end indicator? */
939 if (CHECK(parser->buffer, ']'))
940 return yaml_parser_fetch_flow_collection_end(parser,
941 YAML_FLOW_SEQUENCE_END_TOKEN);
943 /* Is it the flow mapping end indicator? */
945 if (CHECK(parser->buffer, '}'))
946 return yaml_parser_fetch_flow_collection_end(parser,
947 YAML_FLOW_MAPPING_END_TOKEN);
949 /* Is it the flow entry indicator? */
951 if (CHECK(parser->buffer, ','))
952 return yaml_parser_fetch_flow_entry(parser);
954 /* Is it the block entry indicator? */
956 if (CHECK(parser->buffer, '-') && IS_BLANKZ_AT(parser->buffer, 1))
957 return yaml_parser_fetch_block_entry(parser);
959 /* Is it the key indicator? */
961 if (CHECK(parser->buffer, '?')
962 && (parser->flow_level || IS_BLANKZ_AT(parser->buffer, 1)))
963 return yaml_parser_fetch_key(parser);
965 /* Is it the value indicator? */
967 if (CHECK(parser->buffer, ':')
968 && (parser->flow_level || IS_BLANKZ_AT(parser->buffer, 1)))
969 return yaml_parser_fetch_value(parser);
971 /* Is it an alias? */
973 if (CHECK(parser->buffer, '*'))
974 return yaml_parser_fetch_anchor(parser, YAML_ALIAS_TOKEN);
976 /* Is it an anchor? */
978 if (CHECK(parser->buffer, '&'))
979 return yaml_parser_fetch_anchor(parser, YAML_ANCHOR_TOKEN);
981 /* Is it a tag? */
983 if (CHECK(parser->buffer, '!'))
984 return yaml_parser_fetch_tag(parser);
986 /* Is it a literal scalar? */
988 if (CHECK(parser->buffer, '|') && !parser->flow_level)
989 return yaml_parser_fetch_block_scalar(parser, 1);
991 /* Is it a folded scalar? */
993 if (CHECK(parser->buffer, '>') && !parser->flow_level)
994 return yaml_parser_fetch_block_scalar(parser, 0);
996 /* Is it a single-quoted scalar? */
998 if (CHECK(parser->buffer, '\''))
999 return yaml_parser_fetch_flow_scalar(parser, 1);
1001 /* Is it a double-quoted scalar? */
1003 if (CHECK(parser->buffer, '"'))
1004 return yaml_parser_fetch_flow_scalar(parser, 0);
1006 /*
1007 * Is it a plain scalar?
1009 * A plain scalar may start with any non-blank characters except
1011 * '-', '?', ':', ',', '[', ']', '{', '}',
1012 * '#', '&', '*', '!', '|', '>', '\'', '\"',
1013 * '%', '@', '`'.
1015 * In the block context (and, for the '-' indicator, in the flow context
1016 * too), it may also start with the characters
1018 * '-', '?', ':'
1020 * if it is followed by a non-space character.
1022 * The last rule is more restrictive than the specification requires.
1023 */
1025 if (!(IS_BLANKZ(parser->buffer) || CHECK(parser->buffer, '-')
1026 || CHECK(parser->buffer, '?') || CHECK(parser->buffer, ':')
1027 || CHECK(parser->buffer, ',') || CHECK(parser->buffer, '[')
1028 || CHECK(parser->buffer, ']') || CHECK(parser->buffer, '{')
1029 || CHECK(parser->buffer, '}') || CHECK(parser->buffer, '#')
1030 || CHECK(parser->buffer, '&') || CHECK(parser->buffer, '*')
1031 || CHECK(parser->buffer, '!') || CHECK(parser->buffer, '|')
1032 || CHECK(parser->buffer, '>') || CHECK(parser->buffer, '\'')
1033 || CHECK(parser->buffer, '"') || CHECK(parser->buffer, '%')
1034 || CHECK(parser->buffer, '@') || CHECK(parser->buffer, '`')) ||
1035 (CHECK(parser->buffer, '-') && !IS_BLANK_AT(parser->buffer, 1)) ||
1036 (!parser->flow_level &&
1037 (CHECK(parser->buffer, '?') || CHECK(parser->buffer, ':'))
1038 && !IS_BLANKZ_AT(parser->buffer, 1)))
1039 return yaml_parser_fetch_plain_scalar(parser);
1041 /*
1042 * If we don't determine the token type so far, it is an error.
1043 */
1045 return yaml_parser_set_scanner_error(parser,
1046 "while scanning for the next token", parser->mark,
1047 "found character that cannot start any token");
1051 * Check the list of potential simple keys and remove the positions that
1052 * cannot contain simple keys anymore.
1053 */
1055static int
1056yaml_parser_stale_simple_keys(yaml_parser_t *parser)
1058 yaml_simple_key_t *simple_key;
1060 /* Check for a potential simple key for each flow level. */
1062 for (simple_key = parser->simple_keys.start;
1063 simple_key != parser->simple_keys.top; simple_key ++)
1065 /*
1066 * The specification requires that a simple key
1068 * - is limited to a single line,
1069 * - is shorter than 1024 characters.
1070 */
1072 if (simple_key->possible
1073 && (simple_key->mark.line < parser->mark.line
1074 || simple_key->mark.index+1024 < parser->mark.index)) {
1076 /* Check if the potential simple key to be removed is required. */
1078 if (simple_key->required) {
1079 return yaml_parser_set_scanner_error(parser,
1080 "while scanning a simple key", simple_key->mark,
1081 "could not find expected ':'");
1084 simple_key->possible = 0;
1088 return 1;
1092 * Check if a simple key may start at the current position and add it if
1093 * needed.
1094 */
1096static int
1097yaml_parser_save_simple_key(yaml_parser_t *parser)
1099 /*
1100 * A simple key is required at the current position if the scanner is in
1101 * the block context and the current column coincides with the indentation
1102 * level.
1103 */
1105 int required = (!parser->flow_level
1106 && parser->indent == (ptrdiff_t)parser->mark.column);
1108 /*
1109 * If the current position may start a simple key, save it.
1110 */
1112 if (parser->simple_key_allowed)
1114 yaml_simple_key_t simple_key;
1115 simple_key.possible = 1;
1116 simple_key.required = required;
1117 simple_key.token_number =
1118 parser->tokens_parsed + (parser->tokens.tail - parser->tokens.head);
1119 simple_key.mark = parser->mark;
1121 if (!yaml_parser_remove_simple_key(parser)) return 0;
1123 *(parser->simple_keys.top-1) = simple_key;
1126 return 1;
1130 * Remove a potential simple key at the current flow level.
1131 */
1133static int
1134yaml_parser_remove_simple_key(yaml_parser_t *parser)
1136 yaml_simple_key_t *simple_key = parser->simple_keys.top-1;
1138 if (simple_key->possible)
1140 /* If the key is required, it is an error. */
1142 if (simple_key->required) {
1143 return yaml_parser_set_scanner_error(parser,
1144 "while scanning a simple key", simple_key->mark,
1145 "could not find expected ':'");
1149 /* Remove the key from the stack. */
1151 simple_key->possible = 0;
1153 return 1;
1157 * Increase the flow level and resize the simple key list if needed.
1158 */
1160static int
1161yaml_parser_increase_flow_level(yaml_parser_t *parser)
1163 yaml_simple_key_t empty_simple_key = { 0, 0, 0, { 0, 0, 0 } };
1165 /* Reset the simple key on the next level. */
1167 if (!PUSH(parser, parser->simple_keys, empty_simple_key))
1168 return 0;
1170 /* Increase the flow level. */
1172 if (parser->flow_level == INT_MAX) {
1173 parser->error = YAML_MEMORY_ERROR;
1174 return 0;
1177 parser->flow_level++;
1179 return 1;
1183 * Decrease the flow level.
1184 */
1186static int
1187yaml_parser_decrease_flow_level(yaml_parser_t *parser)
1189 yaml_simple_key_t dummy_key; /* Used to eliminate a compiler warning. */
1191 if (parser->flow_level) {
1192 parser->flow_level --;
1193 dummy_key = POP(parser, parser->simple_keys);
1196 return 1;
1200 * Push the current indentation level to the stack and set the new level
1201 * the current column is greater than the indentation level. In this case,
1202 * append or insert the specified token into the token queue.
1203 *
1204 */
1206static int
1207yaml_parser_roll_indent(yaml_parser_t *parser, ptrdiff_t column,
1208 ptrdiff_t number, yaml_token_type_t type, yaml_mark_t mark)
1210 yaml_token_t token;
1212 /* In the flow context, do nothing. */
1214 if (parser->flow_level)
1215 return 1;
1217 if (parser->indent < column)
1219 /*
1220 * Push the current indentation level to the stack and set the new
1221 * indentation level.
1222 */
1224 if (!PUSH(parser, parser->indents, parser->indent))
1225 return 0;
1227 if (column > INT_MAX) {
1228 parser->error = YAML_MEMORY_ERROR;
1229 return 0;
1232 parser->indent = column;
1234 /* Create a token and insert it into the queue. */
1236 TOKEN_INIT(token, type, mark, mark);
1238 if (number == -1) {
1239 if (!ENQUEUE(parser, parser->tokens, token))
1240 return 0;
1242 else {
1243 if (!QUEUE_INSERT(parser,
1244 parser->tokens, number - parser->tokens_parsed, token))
1245 return 0;
1249 return 1;
1253 * Pop indentation levels from the indents stack until the current level
1254 * becomes less or equal to the column. For each intendation level, append
1255 * the BLOCK-END token.
1256 */
1259static int
1260yaml_parser_unroll_indent(yaml_parser_t *parser, ptrdiff_t column)
1262 yaml_token_t token;
1264 /* In the flow context, do nothing. */
1266 if (parser->flow_level)
1267 return 1;
1269 /* Loop through the intendation levels in the stack. */
1271 while (parser->indent > column)
1273 /* Create a token and append it to the queue. */
1275 TOKEN_INIT(token, YAML_BLOCK_END_TOKEN, parser->mark, parser->mark);
1277 if (!ENQUEUE(parser, parser->tokens, token))
1278 return 0;
1280 /* Pop the indentation level. */
1282 parser->indent = POP(parser, parser->indents);
1285 return 1;
1289 * Initialize the scanner and produce the STREAM-START token.
1290 */
1292static int
1293yaml_parser_fetch_stream_start(yaml_parser_t *parser)
1295 yaml_simple_key_t simple_key = { 0, 0, 0, { 0, 0, 0 } };
1296 yaml_token_t token;
1298 /* Set the initial indentation. */
1300 parser->indent = -1;
1302 /* Initialize the simple key stack. */
1304 if (!PUSH(parser, parser->simple_keys, simple_key))
1305 return 0;
1307 /* A simple key is allowed at the beginning of the stream. */
1309 parser->simple_key_allowed = 1;
1311 /* We have started. */
1313 parser->stream_start_produced = 1;
1315 /* Create the STREAM-START token and append it to the queue. */
1317 STREAM_START_TOKEN_INIT(token, parser->encoding,
1318 parser->mark, parser->mark);
1320 if (!ENQUEUE(parser, parser->tokens, token))
1321 return 0;
1323 return 1;
1327 * Produce the STREAM-END token and shut down the scanner.
1328 */
1330static int
1331yaml_parser_fetch_stream_end(yaml_parser_t *parser)
1333 yaml_token_t token;
1335 /* Force new line. */
1337 if (parser->mark.column != 0) {
1338 parser->mark.column = 0;
1339 parser->mark.line ++;
1342 /* Reset the indentation level. */
1344 if (!yaml_parser_unroll_indent(parser, -1))
1345 return 0;
1347 /* Reset simple keys. */
1349 if (!yaml_parser_remove_simple_key(parser))
1350 return 0;
1352 parser->simple_key_allowed = 0;
1354 /* Create the STREAM-END token and append it to the queue. */
1356 STREAM_END_TOKEN_INIT(token, parser->mark, parser->mark);
1358 if (!ENQUEUE(parser, parser->tokens, token))
1359 return 0;
1361 return 1;
1365 * Produce a VERSION-DIRECTIVE or TAG-DIRECTIVE token.
1366 */
1368static int
1369yaml_parser_fetch_directive(yaml_parser_t *parser)
1371 yaml_token_t token;
1373 /* Reset the indentation level. */
1375 if (!yaml_parser_unroll_indent(parser, -1))
1376 return 0;
1378 /* Reset simple keys. */
1380 if (!yaml_parser_remove_simple_key(parser))
1381 return 0;
1383 parser->simple_key_allowed = 0;
1385 /* Create the YAML-DIRECTIVE or TAG-DIRECTIVE token. */
1387 if (!yaml_parser_scan_directive(parser, &token))
1388 return 0;
1390 /* Append the token to the queue. */
1392 if (!ENQUEUE(parser, parser->tokens, token)) {
1393 yaml_token_delete(&token);
1394 return 0;
1397 return 1;
1401 * Produce the DOCUMENT-START or DOCUMENT-END token.
1402 */
1404static int
1405yaml_parser_fetch_document_indicator(yaml_parser_t *parser,
1406 yaml_token_type_t type)
1408 yaml_mark_t start_mark, end_mark;
1409 yaml_token_t token;
1411 /* Reset the indentation level. */
1413 if (!yaml_parser_unroll_indent(parser, -1))
1414 return 0;
1416 /* Reset simple keys. */
1418 if (!yaml_parser_remove_simple_key(parser))
1419 return 0;
1421 parser->simple_key_allowed = 0;
1423 /* Consume the token. */
1425 start_mark = parser->mark;
1427 SKIP(parser);
1428 SKIP(parser);
1429 SKIP(parser);
1431 end_mark = parser->mark;
1433 /* Create the DOCUMENT-START or DOCUMENT-END token. */
1435 TOKEN_INIT(token, type, start_mark, end_mark);
1437 /* Append the token to the queue. */
1439 if (!ENQUEUE(parser, parser->tokens, token))
1440 return 0;
1442 return 1;
1446 * Produce the FLOW-SEQUENCE-START or FLOW-MAPPING-START token.
1447 */
1449static int
1450yaml_parser_fetch_flow_collection_start(yaml_parser_t *parser,
1451 yaml_token_type_t type)
1453 yaml_mark_t start_mark, end_mark;
1454 yaml_token_t token;
1456 /* The indicators '[' and '{' may start a simple key. */
1458 if (!yaml_parser_save_simple_key(parser))
1459 return 0;
1461 /* Increase the flow level. */
1463 if (!yaml_parser_increase_flow_level(parser))
1464 return 0;
1466 /* A simple key may follow the indicators '[' and '{'. */
1468 parser->simple_key_allowed = 1;
1470 /* Consume the token. */
1472 start_mark = parser->mark;
1473 SKIP(parser);
1474 end_mark = parser->mark;
1476 /* Create the FLOW-SEQUENCE-START of FLOW-MAPPING-START token. */
1478 TOKEN_INIT(token, type, start_mark, end_mark);
1480 /* Append the token to the queue. */
1482 if (!ENQUEUE(parser, parser->tokens, token))
1483 return 0;
1485 return 1;
1489 * Produce the FLOW-SEQUENCE-END or FLOW-MAPPING-END token.
1490 */
1492static int
1493yaml_parser_fetch_flow_collection_end(yaml_parser_t *parser,
1494 yaml_token_type_t type)
1496 yaml_mark_t start_mark, end_mark;
1497 yaml_token_t token;
1499 /* Reset any potential simple key on the current flow level. */
1501 if (!yaml_parser_remove_simple_key(parser))
1502 return 0;
1504 /* Decrease the flow level. */
1506 if (!yaml_parser_decrease_flow_level(parser))
1507 return 0;
1509 /* No simple keys after the indicators ']' and '}'. */
1511 parser->simple_key_allowed = 0;
1513 /* Consume the token. */
1515 start_mark = parser->mark;
1516 SKIP(parser);
1517 end_mark = parser->mark;
1519 /* Create the FLOW-SEQUENCE-END of FLOW-MAPPING-END token. */
1521 TOKEN_INIT(token, type, start_mark, end_mark);
1523 /* Append the token to the queue. */
1525 if (!ENQUEUE(parser, parser->tokens, token))
1526 return 0;
1528 return 1;
1532 * Produce the FLOW-ENTRY token.
1533 */
1535static int
1536yaml_parser_fetch_flow_entry(yaml_parser_t *parser)
1538 yaml_mark_t start_mark, end_mark;
1539 yaml_token_t token;
1541 /* Reset any potential simple keys on the current flow level. */
1543 if (!yaml_parser_remove_simple_key(parser))
1544 return 0;
1546 /* Simple keys are allowed after ','. */
1548 parser->simple_key_allowed = 1;
1550 /* Consume the token. */
1552 start_mark = parser->mark;
1553 SKIP(parser);
1554 end_mark = parser->mark;
1556 /* Create the FLOW-ENTRY token and append it to the queue. */
1558 TOKEN_INIT(token, YAML_FLOW_ENTRY_TOKEN, start_mark, end_mark);
1560 if (!ENQUEUE(parser, parser->tokens, token))
1561 return 0;
1563 return 1;
1567 * Produce the BLOCK-ENTRY token.
1568 */
1570static int
1571yaml_parser_fetch_block_entry(yaml_parser_t *parser)
1573 yaml_mark_t start_mark, end_mark;
1574 yaml_token_t token;
1576 /* Check if the scanner is in the block context. */
1578 if (!parser->flow_level)
1580 /* Check if we are allowed to start a new entry. */
1582 if (!parser->simple_key_allowed) {
1583 return yaml_parser_set_scanner_error(parser, NULL, parser->mark,
1584 "block sequence entries are not allowed in this context");
1587 /* Add the BLOCK-SEQUENCE-START token if needed. */
1589 if (!yaml_parser_roll_indent(parser, parser->mark.column, -1,
1590 YAML_BLOCK_SEQUENCE_START_TOKEN, parser->mark))
1591 return 0;
1593 else
1595 /*
1596 * It is an error for the '-' indicator to occur in the flow context,
1597 * but we let the Parser detect and report about it because the Parser
1598 * is able to point to the context.
1599 */
1602 /* Reset any potential simple keys on the current flow level. */
1604 if (!yaml_parser_remove_simple_key(parser))
1605 return 0;
1607 /* Simple keys are allowed after '-'. */
1609 parser->simple_key_allowed = 1;
1611 /* Consume the token. */
1613 start_mark = parser->mark;
1614 SKIP(parser);
1615 end_mark = parser->mark;
1617 /* Create the BLOCK-ENTRY token and append it to the queue. */
1619 TOKEN_INIT(token, YAML_BLOCK_ENTRY_TOKEN, start_mark, end_mark);
1621 if (!ENQUEUE(parser, parser->tokens, token))
1622 return 0;
1624 return 1;
1628 * Produce the KEY token.
1629 */
1631static int
1632yaml_parser_fetch_key(yaml_parser_t *parser)
1634 yaml_mark_t start_mark, end_mark;
1635 yaml_token_t token;
1637 /* In the block context, additional checks are required. */
1639 if (!parser->flow_level)
1641 /* Check if we are allowed to start a new key (not nessesary simple). */
1643 if (!parser->simple_key_allowed) {
1644 return yaml_parser_set_scanner_error(parser, NULL, parser->mark,
1645 "mapping keys are not allowed in this context");
1648 /* Add the BLOCK-MAPPING-START token if needed. */
1650 if (!yaml_parser_roll_indent(parser, parser->mark.column, -1,
1651 YAML_BLOCK_MAPPING_START_TOKEN, parser->mark))
1652 return 0;
1655 /* Reset any potential simple keys on the current flow level. */
1657 if (!yaml_parser_remove_simple_key(parser))
1658 return 0;
1660 /* Simple keys are allowed after '?' in the block context. */
1662 parser->simple_key_allowed = (!parser->flow_level);
1664 /* Consume the token. */
1666 start_mark = parser->mark;
1667 SKIP(parser);
1668 end_mark = parser->mark;
1670 /* Create the KEY token and append it to the queue. */
1672 TOKEN_INIT(token, YAML_KEY_TOKEN, start_mark, end_mark);
1674 if (!ENQUEUE(parser, parser->tokens, token))
1675 return 0;
1677 return 1;
1681 * Produce the VALUE token.
1682 */
1684static int
1685yaml_parser_fetch_value(yaml_parser_t *parser)
1687 yaml_mark_t start_mark, end_mark;
1688 yaml_token_t token;
1689 yaml_simple_key_t *simple_key = parser->simple_keys.top-1;
1691 /* Have we found a simple key? */
1693 if (simple_key->possible)
1696 /* Create the KEY token and insert it into the queue. */
1698 TOKEN_INIT(token, YAML_KEY_TOKEN, simple_key->mark, simple_key->mark);
1700 if (!QUEUE_INSERT(parser, parser->tokens,
1701 simple_key->token_number - parser->tokens_parsed, token))
1702 return 0;
1704 /* In the block context, we may need to add the BLOCK-MAPPING-START token. */
1706 if (!yaml_parser_roll_indent(parser, simple_key->mark.column,
1707 simple_key->token_number,
1708 YAML_BLOCK_MAPPING_START_TOKEN, simple_key->mark))
1709 return 0;
1711 /* Remove the simple key. */
1713 simple_key->possible = 0;
1715 /* A simple key cannot follow another simple key. */
1717 parser->simple_key_allowed = 0;
1719 else
1721 /* The ':' indicator follows a complex key. */
1723 /* In the block context, extra checks are required. */
1725 if (!parser->flow_level)
1727 /* Check if we are allowed to start a complex value. */
1729 if (!parser->simple_key_allowed) {
1730 return yaml_parser_set_scanner_error(parser, NULL, parser->mark,
1731 "mapping values are not allowed in this context");
1734 /* Add the BLOCK-MAPPING-START token if needed. */
1736 if (!yaml_parser_roll_indent(parser, parser->mark.column, -1,
1737 YAML_BLOCK_MAPPING_START_TOKEN, parser->mark))
1738 return 0;
1741 /* Simple keys after ':' are allowed in the block context. */
1743 parser->simple_key_allowed = (!parser->flow_level);
1746 /* Consume the token. */
1748 start_mark = parser->mark;
1749 SKIP(parser);
1750 end_mark = parser->mark;
1752 /* Create the VALUE token and append it to the queue. */
1754 TOKEN_INIT(token, YAML_VALUE_TOKEN, start_mark, end_mark);
1756 if (!ENQUEUE(parser, parser->tokens, token))
1757 return 0;
1759 return 1;
1763 * Produce the ALIAS or ANCHOR token.
1764 */
1766static int
1767yaml_parser_fetch_anchor(yaml_parser_t *parser, yaml_token_type_t type)
1769 yaml_token_t token;
1771 /* An anchor or an alias could be a simple key. */
1773 if (!yaml_parser_save_simple_key(parser))
1774 return 0;
1776 /* A simple key cannot follow an anchor or an alias. */
1778 parser->simple_key_allowed = 0;
1780 /* Create the ALIAS or ANCHOR token and append it to the queue. */
1782 if (!yaml_parser_scan_anchor(parser, &token, type))
1783 return 0;
1785 if (!ENQUEUE(parser, parser->tokens, token)) {
1786 yaml_token_delete(&token);
1787 return 0;
1789 return 1;
1793 * Produce the TAG token.
1794 */
1796static int
1797yaml_parser_fetch_tag(yaml_parser_t *parser)
1799 yaml_token_t token;
1801 /* A tag could be a simple key. */
1803 if (!yaml_parser_save_simple_key(parser))
1804 return 0;
1806 /* A simple key cannot follow a tag. */
1808 parser->simple_key_allowed = 0;
1810 /* Create the TAG token and append it to the queue. */
1812 if (!yaml_parser_scan_tag(parser, &token))
1813 return 0;
1815 if (!ENQUEUE(parser, parser->tokens, token)) {
1816 yaml_token_delete(&token);
1817 return 0;
1820 return 1;
1824 * Produce the SCALAR(...,literal) or SCALAR(...,folded) tokens.
1825 */
1827static int
1828yaml_parser_fetch_block_scalar(yaml_parser_t *parser, int literal)
1830 yaml_token_t token;
1832 /* Remove any potential simple keys. */
1834 if (!yaml_parser_remove_simple_key(parser))
1835 return 0;
1837 /* A simple key may follow a block scalar. */
1839 parser->simple_key_allowed = 1;
1841 /* Create the SCALAR token and append it to the queue. */
1843 if (!yaml_parser_scan_block_scalar(parser, &token, literal))
1844 return 0;
1846 if (!ENQUEUE(parser, parser->tokens, token)) {
1847 yaml_token_delete(&token);
1848 return 0;
1851 return 1;
1855 * Produce the SCALAR(...,single-quoted) or SCALAR(...,double-quoted) tokens.
1856 */
1858static int
1859yaml_parser_fetch_flow_scalar(yaml_parser_t *parser, int single)
1861 yaml_token_t token;
1863 /* A plain scalar could be a simple key. */
1865 if (!yaml_parser_save_simple_key(parser))
1866 return 0;
1868 /* A simple key cannot follow a flow scalar. */
1870 parser->simple_key_allowed = 0;
1872 /* Create the SCALAR token and append it to the queue. */
1874 if (!yaml_parser_scan_flow_scalar(parser, &token, single))
1875 return 0;
1877 if (!ENQUEUE(parser, parser->tokens, token)) {
1878 yaml_token_delete(&token);
1879 return 0;
1882 return 1;
1886 * Produce the SCALAR(...,plain) token.
1887 */
1889static int
1890yaml_parser_fetch_plain_scalar(yaml_parser_t *parser)
1892 yaml_token_t token;
1894 /* A plain scalar could be a simple key. */
1896 if (!yaml_parser_save_simple_key(parser))
1897 return 0;
1899 /* A simple key cannot follow a flow scalar. */
1901 parser->simple_key_allowed = 0;
1903 /* Create the SCALAR token and append it to the queue. */
1905 if (!yaml_parser_scan_plain_scalar(parser, &token))
1906 return 0;
1908 if (!ENQUEUE(parser, parser->tokens, token)) {
1909 yaml_token_delete(&token);
1910 return 0;
1913 return 1;
1917 * Eat whitespaces and comments until the next token is found.
1918 */
1920static int
1921yaml_parser_scan_to_next_token(yaml_parser_t *parser)
1923 /* Until the next token is not found. */
1925 while (1)
1927 /* Allow the BOM mark to start a line. */
1929 if (!CACHE(parser, 1)) return 0;
1931 if (parser->mark.column == 0 && IS_BOM(parser->buffer))
1932 SKIP(parser);
1934 /*
1935 * Eat whitespaces.
1937 * Tabs are allowed:
1939 * - in the flow context;
1940 * - in the block context, but not at the beginning of the line or
1941 * after '-', '?', or ':' (complex value).
1942 */
1944 if (!CACHE(parser, 1)) return 0;
1946 while (CHECK(parser->buffer,' ') ||
1947 ((parser->flow_level || !parser->simple_key_allowed) &&
1948 CHECK(parser->buffer, '\t'))) {
1949 SKIP(parser);
1950 if (!CACHE(parser, 1)) return 0;
1953 /* Eat a comment until a line break. */
1955 if (CHECK(parser->buffer, '#')) {
1956 while (!IS_BREAKZ(parser->buffer)) {
1957 SKIP(parser);
1958 if (!CACHE(parser, 1)) return 0;
1962 /* If it is a line break, eat it. */
1964 if (IS_BREAK(parser->buffer))
1966 if (!CACHE(parser, 2)) return 0;
1967 SKIP_LINE(parser);
1969 /* In the block context, a new line may start a simple key. */
1971 if (!parser->flow_level) {
1972 parser->simple_key_allowed = 1;
1975 else
1977 /* We have found a token. */
1979 break;
1983 return 1;
1987 * Scan a YAML-DIRECTIVE or TAG-DIRECTIVE token.
1989 * Scope:
1990 * %YAML 1.1 # a comment \n
1991 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1992 * %TAG !yaml! tag:yaml.org,2002: \n
1993 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
1994 */
1996int
1997yaml_parser_scan_directive(yaml_parser_t *parser, yaml_token_t *token)
1999 yaml_mark_t start_mark, end_mark;
2000 yaml_char_t *name = NULL;
2001 int major, minor;
2002 yaml_char_t *handle = NULL, *prefix = NULL;
2004 /* Eat '%'. */
2006 start_mark = parser->mark;
2008 SKIP(parser);
2010 /* Scan the directive name. */
2012 if (!yaml_parser_scan_directive_name(parser, start_mark, &name))
2013 goto error;
2015 /* Is it a YAML directive? */
2017 if (strcmp((char *)name, "YAML") == 0)
2019 /* Scan the VERSION directive value. */
2021 if (!yaml_parser_scan_version_directive_value(parser, start_mark,
2022 &major, &minor))
2023 goto error;
2025 end_mark = parser->mark;
2027 /* Create a VERSION-DIRECTIVE token. */
2029 VERSION_DIRECTIVE_TOKEN_INIT(*token, major, minor,
2030 start_mark, end_mark);
2033 /* Is it a TAG directive? */
2035 else if (strcmp((char *)name, "TAG") == 0)
2037 /* Scan the TAG directive value. */
2039 if (!yaml_parser_scan_tag_directive_value(parser, start_mark,
2040 &handle, &prefix))
2041 goto error;
2043 end_mark = parser->mark;
2045 /* Create a TAG-DIRECTIVE token. */
2047 TAG_DIRECTIVE_TOKEN_INIT(*token, handle, prefix,
2048 start_mark, end_mark);
2051 /* Unknown directive. */
2053 else
2055 yaml_parser_set_scanner_error(parser, "while scanning a directive",
2056 start_mark, "found uknown directive name");
2057 goto error;
2060 /* Eat the rest of the line including any comments. */
2062 if (!CACHE(parser, 1)) goto error;
2064 while (IS_BLANK(parser->buffer)) {
2065 SKIP(parser);
2066 if (!CACHE(parser, 1)) goto error;
2069 if (CHECK(parser->buffer, '#')) {
2070 while (!IS_BREAKZ(parser->buffer)) {
2071 SKIP(parser);
2072 if (!CACHE(parser, 1)) goto error;
2076 /* Check if we are at the end of the line. */
2078 if (!IS_BREAKZ(parser->buffer)) {
2079 yaml_parser_set_scanner_error(parser, "while scanning a directive",
2080 start_mark, "did not find expected comment or line break");
2081 goto error;
2084 /* Eat a line break. */
2086 if (IS_BREAK(parser->buffer)) {
2087 if (!CACHE(parser, 2)) goto error;
2088 SKIP_LINE(parser);
2091 yaml_free(name);
2093 return 1;
2095error:
2096 yaml_free(prefix);
2097 yaml_free(handle);
2098 yaml_free(name);
2099 return 0;
2103 * Scan the directive name.
2105 * Scope:
2106 * %YAML 1.1 # a comment \n
2107 * ^^^^
2108 * %TAG !yaml! tag:yaml.org,2002: \n
2109 * ^^^
2110 */
2112static int
2113yaml_parser_scan_directive_name(yaml_parser_t *parser,
2114 yaml_mark_t start_mark, yaml_char_t **name)
2116 yaml_string_t string = NULL_STRING;
2118 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
2120 /* Consume the directive name. */
2122 if (!CACHE(parser, 1)) goto error;
2124 while (IS_ALPHA(parser->buffer))
2126 if (!READ(parser, string)) goto error;
2127 if (!CACHE(parser, 1)) goto error;
2130 /* Check if the name is empty. */
2132 if (string.start == string.pointer) {
2133 yaml_parser_set_scanner_error(parser, "while scanning a directive",
2134 start_mark, "could not find expected directive name");
2135 goto error;
2138 /* Check for an blank character after the name. */
2140 if (!IS_BLANKZ(parser->buffer)) {
2141 yaml_parser_set_scanner_error(parser, "while scanning a directive",
2142 start_mark, "found unexpected non-alphabetical character");
2143 goto error;
2146 *name = string.start;
2148 return 1;
2150error:
2151 STRING_DEL(parser, string);
2152 return 0;
2156 * Scan the value of VERSION-DIRECTIVE.
2158 * Scope:
2159 * %YAML 1.1 # a comment \n
2160 * ^^^^^^
2161 */
2163static int
2164yaml_parser_scan_version_directive_value(yaml_parser_t *parser,
2165 yaml_mark_t start_mark, int *major, int *minor)
2167 /* Eat whitespaces. */
2169 if (!CACHE(parser, 1)) return 0;
2171 while (IS_BLANK(parser->buffer)) {
2172 SKIP(parser);
2173 if (!CACHE(parser, 1)) return 0;
2176 /* Consume the major version number. */
2178 if (!yaml_parser_scan_version_directive_number(parser, start_mark, major))
2179 return 0;
2181 /* Eat '.'. */
2183 if (!CHECK(parser->buffer, '.')) {
2184 return yaml_parser_set_scanner_error(parser, "while scanning a %YAML directive",
2185 start_mark, "did not find expected digit or '.' character");
2188 SKIP(parser);
2190 /* Consume the minor version number. */
2192 if (!yaml_parser_scan_version_directive_number(parser, start_mark, minor))
2193 return 0;
2195 return 1;
2198#define MAX_NUMBER_LENGTH 9
2201 * Scan the version number of VERSION-DIRECTIVE.
2203 * Scope:
2204 * %YAML 1.1 # a comment \n
2205 * ^
2206 * %YAML 1.1 # a comment \n
2207 * ^
2208 */
2210static int
2211yaml_parser_scan_version_directive_number(yaml_parser_t *parser,
2212 yaml_mark_t start_mark, int *number)
2214 int value = 0;
2215 size_t length = 0;
2217 /* Repeat while the next character is digit. */
2219 if (!CACHE(parser, 1)) return 0;
2221 while (IS_DIGIT(parser->buffer))
2223 /* Check if the number is too long. */
2225 if (++length > MAX_NUMBER_LENGTH) {
2226 return yaml_parser_set_scanner_error(parser, "while scanning a %YAML directive",
2227 start_mark, "found extremely long version number");
2230 value = value*10 + AS_DIGIT(parser->buffer);
2232 SKIP(parser);
2234 if (!CACHE(parser, 1)) return 0;
2237 /* Check if the number was present. */
2239 if (!length) {
2240 return yaml_parser_set_scanner_error(parser, "while scanning a %YAML directive",
2241 start_mark, "did not find expected version number");
2244 *number = value;
2246 return 1;
2250 * Scan the value of a TAG-DIRECTIVE token.
2252 * Scope:
2253 * %TAG !yaml! tag:yaml.org,2002: \n
2254 * ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
2255 */
2257static int
2258yaml_parser_scan_tag_directive_value(yaml_parser_t *parser,
2259 yaml_mark_t start_mark, yaml_char_t **handle, yaml_char_t **prefix)
2261 yaml_char_t *handle_value = NULL;
2262 yaml_char_t *prefix_value = NULL;
2264 /* Eat whitespaces. */
2266 if (!CACHE(parser, 1)) goto error;
2268 while (IS_BLANK(parser->buffer)) {
2269 SKIP(parser);
2270 if (!CACHE(parser, 1)) goto error;
2273 /* Scan a handle. */
2275 if (!yaml_parser_scan_tag_handle(parser, 1, start_mark, &handle_value))
2276 goto error;
2278 /* Expect a whitespace. */
2280 if (!CACHE(parser, 1)) goto error;
2282 if (!IS_BLANK(parser->buffer)) {
2283 yaml_parser_set_scanner_error(parser, "while scanning a %TAG directive",
2284 start_mark, "did not find expected whitespace");
2285 goto error;
2288 /* Eat whitespaces. */
2290 while (IS_BLANK(parser->buffer)) {
2291 SKIP(parser);
2292 if (!CACHE(parser, 1)) goto error;
2295 /* Scan a prefix. */
2297 if (!yaml_parser_scan_tag_uri(parser, 1, NULL, start_mark, &prefix_value))
2298 goto error;
2300 /* Expect a whitespace or line break. */
2302 if (!CACHE(parser, 1)) goto error;
2304 if (!IS_BLANKZ(parser->buffer)) {
2305 yaml_parser_set_scanner_error(parser, "while scanning a %TAG directive",
2306 start_mark, "did not find expected whitespace or line break");
2307 goto error;
2310 *handle = handle_value;
2311 *prefix = prefix_value;
2313 return 1;
2315error:
2316 yaml_free(handle_value);
2317 yaml_free(prefix_value);
2318 return 0;
2321static int
2322yaml_parser_scan_anchor(yaml_parser_t *parser, yaml_token_t *token,
2323 yaml_token_type_t type)
2325 int length = 0;
2326 yaml_mark_t start_mark, end_mark;
2327 yaml_string_t string = NULL_STRING;
2329 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
2331 /* Eat the indicator character. */
2333 start_mark = parser->mark;
2335 SKIP(parser);
2337 /* Consume the value. */
2339 if (!CACHE(parser, 1)) goto error;
2341 while (IS_ALPHA(parser->buffer)) {
2342 if (!READ(parser, string)) goto error;
2343 if (!CACHE(parser, 1)) goto error;
2344 length ++;
2347 end_mark = parser->mark;
2349 /*
2350 * Check if length of the anchor is greater than 0 and it is followed by
2351 * a whitespace character or one of the indicators:
2353 * '?', ':', ',', ']', '}', '%', '@', '`'.
2354 */
2356 if (!length || !(IS_BLANKZ(parser->buffer) || CHECK(parser->buffer, '?')
2357 || CHECK(parser->buffer, ':') || CHECK(parser->buffer, ',')
2358 || CHECK(parser->buffer, ']') || CHECK(parser->buffer, '}')
2359 || CHECK(parser->buffer, '%') || CHECK(parser->buffer, '@')
2360 || CHECK(parser->buffer, '`'))) {
2361 yaml_parser_set_scanner_error(parser, type == YAML_ANCHOR_TOKEN ?
2362 "while scanning an anchor" : "while scanning an alias", start_mark,
2363 "did not find expected alphabetic or numeric character");
2364 goto error;
2367 /* Create a token. */
2369 if (type == YAML_ANCHOR_TOKEN) {
2370 ANCHOR_TOKEN_INIT(*token, string.start, start_mark, end_mark);
2372 else {
2373 ALIAS_TOKEN_INIT(*token, string.start, start_mark, end_mark);
2376 return 1;
2378error:
2379 STRING_DEL(parser, string);
2380 return 0;
2384 * Scan a TAG token.
2385 */
2387static int
2388yaml_parser_scan_tag(yaml_parser_t *parser, yaml_token_t *token)
2390 yaml_char_t *handle = NULL;
2391 yaml_char_t *suffix = NULL;
2392 yaml_mark_t start_mark, end_mark;
2394 start_mark = parser->mark;
2396 /* Check if the tag is in the canonical form. */
2398 if (!CACHE(parser, 2)) goto error;
2400 if (CHECK_AT(parser->buffer, '<', 1))
2402 /* Set the handle to '' */
2404 handle = yaml_malloc(1);
2405 if (!handle) goto error;
2406 handle[0] = '\0';
2408 /* Eat '!<' */
2410 SKIP(parser);
2411 SKIP(parser);
2413 /* Consume the tag value. */
2415 if (!yaml_parser_scan_tag_uri(parser, 0, NULL, start_mark, &suffix))
2416 goto error;
2418 /* Check for '>' and eat it. */
2420 if (!CHECK(parser->buffer, '>')) {
2421 yaml_parser_set_scanner_error(parser, "while scanning a tag",
2422 start_mark, "did not find the expected '>'");
2423 goto error;
2426 SKIP(parser);
2428 else
2430 /* The tag has either the '!suffix' or the '!handle!suffix' form. */
2432 /* First, try to scan a handle. */
2434 if (!yaml_parser_scan_tag_handle(parser, 0, start_mark, &handle))
2435 goto error;
2437 /* Check if it is, indeed, handle. */
2439 if (handle[0] == '!' && handle[1] != '\0' && handle[strlen((char *)handle)-1] == '!')
2441 /* Scan the suffix now. */
2443 if (!yaml_parser_scan_tag_uri(parser, 0, NULL, start_mark, &suffix))
2444 goto error;
2446 else
2448 /* It wasn't a handle after all. Scan the rest of the tag. */
2450 if (!yaml_parser_scan_tag_uri(parser, 0, handle, start_mark, &suffix))
2451 goto error;
2453 /* Set the handle to '!'. */
2455 yaml_free(handle);
2456 handle = yaml_malloc(2);
2457 if (!handle) goto error;
2458 handle[0] = '!';
2459 handle[1] = '\0';
2461 /*
2462 * A special case: the '!' tag. Set the handle to '' and the
2463 * suffix to '!'.
2464 */
2466 if (suffix[0] == '\0') {
2467 yaml_char_t *tmp = handle;
2468 handle = suffix;
2469 suffix = tmp;
2474 /* Check the character which ends the tag. */
2476 if (!CACHE(parser, 1)) goto error;
2478 if (!IS_BLANKZ(parser->buffer)) {
2479 yaml_parser_set_scanner_error(parser, "while scanning a tag",
2480 start_mark, "did not find expected whitespace or line break");
2481 goto error;
2484 end_mark = parser->mark;
2486 /* Create a token. */
2488 TAG_TOKEN_INIT(*token, handle, suffix, start_mark, end_mark);
2490 return 1;
2492error:
2493 yaml_free(handle);
2494 yaml_free(suffix);
2495 return 0;
2499 * Scan a tag handle.
2500 */
2502static int
2503yaml_parser_scan_tag_handle(yaml_parser_t *parser, int directive,
2504 yaml_mark_t start_mark, yaml_char_t **handle)
2506 yaml_string_t string = NULL_STRING;
2508 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
2510 /* Check the initial '!' character. */
2512 if (!CACHE(parser, 1)) goto error;
2514 if (!CHECK(parser->buffer, '!')) {
2515 yaml_parser_set_scanner_error(parser, directive ?
2516 "while scanning a tag directive" : "while scanning a tag",
2517 start_mark, "did not find expected '!'");
2518 goto error;
2521 /* Copy the '!' character. */
2523 if (!READ(parser, string)) goto error;
2525 /* Copy all subsequent alphabetical and numerical characters. */
2527 if (!CACHE(parser, 1)) goto error;
2529 while (IS_ALPHA(parser->buffer))
2531 if (!READ(parser, string)) goto error;
2532 if (!CACHE(parser, 1)) goto error;
2535 /* Check if the trailing character is '!' and copy it. */
2537 if (CHECK(parser->buffer, '!'))
2539 if (!READ(parser, string)) goto error;
2541 else
2543 /*
2544 * It's either the '!' tag or not really a tag handle. If it's a %TAG
2545 * directive, it's an error. If it's a tag token, it must be a part of
2546 * URI.
2547 */
2549 if (directive && !(string.start[0] == '!' && string.start[1] == '\0')) {
2550 yaml_parser_set_scanner_error(parser, "while parsing a tag directive",
2551 start_mark, "did not find expected '!'");
2552 goto error;
2556 *handle = string.start;
2558 return 1;
2560error:
2561 STRING_DEL(parser, string);
2562 return 0;
2566 * Scan a tag.
2567 */
2569static int
2570yaml_parser_scan_tag_uri(yaml_parser_t *parser, int directive,
2571 yaml_char_t *head, yaml_mark_t start_mark, yaml_char_t **uri)
2573 size_t length = head ? strlen((char *)head) : 0;
2574 yaml_string_t string = NULL_STRING;
2576 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
2578 /* Resize the string to include the head. */
2580 while ((size_t)(string.end - string.start) <= length) {
2581 if (!yaml_string_extend(&string.start, &string.pointer, &string.end)) {
2582 parser->error = YAML_MEMORY_ERROR;
2583 goto error;
2587 /*
2588 * Copy the head if needed.
2590 * Note that we don't copy the leading '!' character.
2591 */
2593 if (length > 1) {
2594 memcpy(string.start, head+1, length-1);
2595 string.pointer += length-1;
2598 /* Scan the tag. */
2600 if (!CACHE(parser, 1)) goto error;
2602 /*
2603 * The set of characters that may appear in URI is as follows:
2605 * '0'-'9', 'A'-'Z', 'a'-'z', '_', '-', ';', '/', '?', ':', '@', '&',
2606 * '=', '+', '$', ',', '.', '!', '~', '*', '\'', '(', ')', '[', ']',
2607 * '%'.
2608 */
2610 while (IS_ALPHA(parser->buffer) || CHECK(parser->buffer, ';')
2611 || CHECK(parser->buffer, '/') || CHECK(parser->buffer, '?')
2612 || CHECK(parser->buffer, ':') || CHECK(parser->buffer, '@')
2613 || CHECK(parser->buffer, '&') || CHECK(parser->buffer, '=')
2614 || CHECK(parser->buffer, '+') || CHECK(parser->buffer, '$')
2615 || CHECK(parser->buffer, ',') || CHECK(parser->buffer, '.')
2616 || CHECK(parser->buffer, '!') || CHECK(parser->buffer, '~')
2617 || CHECK(parser->buffer, '*') || CHECK(parser->buffer, '\'')
2618 || CHECK(parser->buffer, '(') || CHECK(parser->buffer, ')')
2619 || CHECK(parser->buffer, '[') || CHECK(parser->buffer, ']')
2620 || CHECK(parser->buffer, '%'))
2622 /* Check if it is a URI-escape sequence. */
2624 if (CHECK(parser->buffer, '%')) {
2625 if (!STRING_EXTEND(parser, string))
2626 goto error;
2628 if (!yaml_parser_scan_uri_escapes(parser,
2629 directive, start_mark, &string)) goto error;
2631 else {
2632 if (!READ(parser, string)) goto error;
2635 length ++;
2636 if (!CACHE(parser, 1)) goto error;
2639 /* Check if the tag is non-empty. */
2641 if (!length) {
2642 if (!STRING_EXTEND(parser, string))
2643 goto error;
2645 yaml_parser_set_scanner_error(parser, directive ?
2646 "while parsing a %TAG directive" : "while parsing a tag",
2647 start_mark, "did not find expected tag URI");
2648 goto error;
2651 *uri = string.start;
2653 return 1;
2655error:
2656 STRING_DEL(parser, string);
2657 return 0;
2661 * Decode an URI-escape sequence corresponding to a single UTF-8 character.
2662 */
2664static int
2665yaml_parser_scan_uri_escapes(yaml_parser_t *parser, int directive,
2666 yaml_mark_t start_mark, yaml_string_t *string)
2668 int width = 0;
2670 /* Decode the required number of characters. */
2672 do {
2674 unsigned char octet = 0;
2676 /* Check for a URI-escaped octet. */
2678 if (!CACHE(parser, 3)) return 0;
2680 if (!(CHECK(parser->buffer, '%')
2681 && IS_HEX_AT(parser->buffer, 1)
2682 && IS_HEX_AT(parser->buffer, 2))) {
2683 return yaml_parser_set_scanner_error(parser, directive ?
2684 "while parsing a %TAG directive" : "while parsing a tag",
2685 start_mark, "did not find URI escaped octet");
2688 /* Get the octet. */
2690 octet = (AS_HEX_AT(parser->buffer, 1) << 4) + AS_HEX_AT(parser->buffer, 2);
2692 /* If it is the leading octet, determine the length of the UTF-8 sequence. */
2694 if (!width)
2696 width = (octet & 0x80) == 0x00 ? 1 :
2697 (octet & 0xE0) == 0xC0 ? 2 :
2698 (octet & 0xF0) == 0xE0 ? 3 :
2699 (octet & 0xF8) == 0xF0 ? 4 : 0;
2700 if (!width) {
2701 return yaml_parser_set_scanner_error(parser, directive ?
2702 "while parsing a %TAG directive" : "while parsing a tag",
2703 start_mark, "found an incorrect leading UTF-8 octet");
2706 else
2708 /* Check if the trailing octet is correct. */
2710 if ((octet & 0xC0) != 0x80) {
2711 return yaml_parser_set_scanner_error(parser, directive ?
2712 "while parsing a %TAG directive" : "while parsing a tag",
2713 start_mark, "found an incorrect trailing UTF-8 octet");
2717 /* Copy the octet and move the pointers. */
2719 *(string->pointer++) = octet;
2720 SKIP(parser);
2721 SKIP(parser);
2722 SKIP(parser);
2724 } while (--width);
2726 return 1;
2730 * Scan a block scalar.
2731 */
2733static int
2734yaml_parser_scan_block_scalar(yaml_parser_t *parser, yaml_token_t *token,
2735 int literal)
2737 yaml_mark_t start_mark;
2738 yaml_mark_t end_mark;
2739 yaml_string_t string = NULL_STRING;
2740 yaml_string_t leading_break = NULL_STRING;
2741 yaml_string_t trailing_breaks = NULL_STRING;
2742 int chomping = 0;
2743 int increment = 0;
2744 int indent = 0;
2745 int leading_blank = 0;
2746 int trailing_blank = 0;
2748 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
2749 if (!STRING_INIT(parser, leading_break, INITIAL_STRING_SIZE)) goto error;
2750 if (!STRING_INIT(parser, trailing_breaks, INITIAL_STRING_SIZE)) goto error;
2752 /* Eat the indicator '|' or '>'. */
2754 start_mark = parser->mark;
2756 SKIP(parser);
2758 /* Scan the additional block scalar indicators. */
2760 if (!CACHE(parser, 1)) goto error;
2762 /* Check for a chomping indicator. */
2764 if (CHECK(parser->buffer, '+') || CHECK(parser->buffer, '-'))
2766 /* Set the chomping method and eat the indicator. */
2768 chomping = CHECK(parser->buffer, '+') ? +1 : -1;
2770 SKIP(parser);
2772 /* Check for an indentation indicator. */
2774 if (!CACHE(parser, 1)) goto error;
2776 if (IS_DIGIT(parser->buffer))
2778 /* Check that the intendation is greater than 0. */
2780 if (CHECK(parser->buffer, '0')) {
2781 yaml_parser_set_scanner_error(parser, "while scanning a block scalar",
2782 start_mark, "found an intendation indicator equal to 0");
2783 goto error;
2786 /* Get the intendation level and eat the indicator. */
2788 increment = AS_DIGIT(parser->buffer);
2790 SKIP(parser);
2794 /* Do the same as above, but in the opposite order. */
2796 else if (IS_DIGIT(parser->buffer))
2798 if (CHECK(parser->buffer, '0')) {
2799 yaml_parser_set_scanner_error(parser, "while scanning a block scalar",
2800 start_mark, "found an intendation indicator equal to 0");
2801 goto error;
2804 increment = AS_DIGIT(parser->buffer);
2806 SKIP(parser);
2808 if (!CACHE(parser, 1)) goto error;
2810 if (CHECK(parser->buffer, '+') || CHECK(parser->buffer, '-')) {
2811 chomping = CHECK(parser->buffer, '+') ? +1 : -1;
2813 SKIP(parser);
2817 /* Eat whitespaces and comments to the end of the line. */
2819 if (!CACHE(parser, 1)) goto error;
2821 while (IS_BLANK(parser->buffer)) {
2822 SKIP(parser);
2823 if (!CACHE(parser, 1)) goto error;
2826 if (CHECK(parser->buffer, '#')) {
2827 while (!IS_BREAKZ(parser->buffer)) {
2828 SKIP(parser);
2829 if (!CACHE(parser, 1)) goto error;
2833 /* Check if we are at the end of the line. */
2835 if (!IS_BREAKZ(parser->buffer)) {
2836 yaml_parser_set_scanner_error(parser, "while scanning a block scalar",
2837 start_mark, "did not find expected comment or line break");
2838 goto error;
2841 /* Eat a line break. */
2843 if (IS_BREAK(parser->buffer)) {
2844 if (!CACHE(parser, 2)) goto error;
2845 SKIP_LINE(parser);
2848 end_mark = parser->mark;
2850 /* Set the intendation level if it was specified. */
2852 if (increment) {
2853 indent = parser->indent >= 0 ? parser->indent+increment : increment;
2856 /* Scan the leading line breaks and determine the indentation level if needed. */
2858 if (!yaml_parser_scan_block_scalar_breaks(parser, &indent, &trailing_breaks,
2859 start_mark, &end_mark)) goto error;
2861 /* Scan the block scalar content. */
2863 if (!CACHE(parser, 1)) goto error;
2865 while ((int)parser->mark.column == indent && !IS_Z(parser->buffer))
2867 /*
2868 * We are at the beginning of a non-empty line.
2869 */
2871 /* Is it a trailing whitespace? */
2873 trailing_blank = IS_BLANK(parser->buffer);
2875 /* Check if we need to fold the leading line break. */
2877 if (!literal && (*leading_break.start == '\n')
2878 && !leading_blank && !trailing_blank)
2880 /* Do we need to join the lines by space? */
2882 if (*trailing_breaks.start == '\0') {
2883 if (!STRING_EXTEND(parser, string)) goto error;
2884 *(string.pointer ++) = ' ';
2887 CLEAR(parser, leading_break);
2889 else {
2890 if (!JOIN(parser, string, leading_break)) goto error;
2891 CLEAR(parser, leading_break);
2894 /* Append the remaining line breaks. */
2896 if (!JOIN(parser, string, trailing_breaks)) goto error;
2897 CLEAR(parser, trailing_breaks);
2899 /* Is it a leading whitespace? */
2901 leading_blank = IS_BLANK(parser->buffer);
2903 /* Consume the current line. */
2905 while (!IS_BREAKZ(parser->buffer)) {
2906 if (!READ(parser, string)) goto error;
2907 if (!CACHE(parser, 1)) goto error;
2910 /* Consume the line break. */
2912 if (!CACHE(parser, 2)) goto error;
2914 if (!READ_LINE(parser, leading_break)) goto error;
2916 /* Eat the following intendation spaces and line breaks. */
2918 if (!yaml_parser_scan_block_scalar_breaks(parser,
2919 &indent, &trailing_breaks, start_mark, &end_mark)) goto error;
2922 /* Chomp the tail. */
2924 if (chomping != -1) {
2925 if (!JOIN(parser, string, leading_break)) goto error;
2927 if (chomping == 1) {
2928 if (!JOIN(parser, string, trailing_breaks)) goto error;
2931 /* Create a token. */
2933 SCALAR_TOKEN_INIT(*token, string.start, string.pointer-string.start,
2934 literal ? YAML_LITERAL_SCALAR_STYLE : YAML_FOLDED_SCALAR_STYLE,
2935 start_mark, end_mark);
2937 STRING_DEL(parser, leading_break);
2938 STRING_DEL(parser, trailing_breaks);
2940 return 1;
2942error:
2943 STRING_DEL(parser, string);
2944 STRING_DEL(parser, leading_break);
2945 STRING_DEL(parser, trailing_breaks);
2947 return 0;
2951 * Scan intendation spaces and line breaks for a block scalar. Determine the
2952 * intendation level if needed.
2953 */
2955static int
2956yaml_parser_scan_block_scalar_breaks(yaml_parser_t *parser,
2957 int *indent, yaml_string_t *breaks,
2958 yaml_mark_t start_mark, yaml_mark_t *end_mark)
2960 int max_indent = 0;
2962 *end_mark = parser->mark;
2964 /* Eat the intendation spaces and line breaks. */
2966 while (1)
2968 /* Eat the intendation spaces. */
2970 if (!CACHE(parser, 1)) return 0;
2972 while ((!*indent || (int)parser->mark.column < *indent)
2973 && IS_SPACE(parser->buffer)) {
2974 SKIP(parser);
2975 if (!CACHE(parser, 1)) return 0;
2978 if ((int)parser->mark.column > max_indent)
2979 max_indent = (int)parser->mark.column;
2981 /* Check for a tab character messing the intendation. */
2983 if ((!*indent || (int)parser->mark.column < *indent)
2984 && IS_TAB(parser->buffer)) {
2985 return yaml_parser_set_scanner_error(parser, "while scanning a block scalar",
2986 start_mark, "found a tab character where an intendation space is expected");
2989 /* Have we found a non-empty line? */
2991 if (!IS_BREAK(parser->buffer)) break;
2993 /* Consume the line break. */
2995 if (!CACHE(parser, 2)) return 0;
2996 if (!READ_LINE(parser, *breaks)) return 0;
2997 *end_mark = parser->mark;
3000 /* Determine the indentation level if needed. */
3002 if (!*indent) {
3003 *indent = max_indent;
3004 if (*indent < parser->indent + 1)
3005 *indent = parser->indent + 1;
3006 if (*indent < 1)
3007 *indent = 1;
3010 return 1;
3014 * Scan a quoted scalar.
3015 */
3017static int
3018yaml_parser_scan_flow_scalar(yaml_parser_t *parser, yaml_token_t *token,
3019 int single)
3021 yaml_mark_t start_mark;
3022 yaml_mark_t end_mark;
3023 yaml_string_t string = NULL_STRING;
3024 yaml_string_t leading_break = NULL_STRING;
3025 yaml_string_t trailing_breaks = NULL_STRING;
3026 yaml_string_t whitespaces = NULL_STRING;
3027 int leading_blanks;
3029 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
3030 if (!STRING_INIT(parser, leading_break, INITIAL_STRING_SIZE)) goto error;
3031 if (!STRING_INIT(parser, trailing_breaks, INITIAL_STRING_SIZE)) goto error;
3032 if (!STRING_INIT(parser, whitespaces, INITIAL_STRING_SIZE)) goto error;
3034 /* Eat the left quote. */
3036 start_mark = parser->mark;
3038 SKIP(parser);
3040 /* Consume the content of the quoted scalar. */
3042 while (1)
3044 /* Check that there are no document indicators at the beginning of the line. */
3046 if (!CACHE(parser, 4)) goto error;
3048 if (parser->mark.column == 0 &&
3049 ((CHECK_AT(parser->buffer, '-', 0) &&
3050 CHECK_AT(parser->buffer, '-', 1) &&
3051 CHECK_AT(parser->buffer, '-', 2)) ||
3052 (CHECK_AT(parser->buffer, '.', 0) &&
3053 CHECK_AT(parser->buffer, '.', 1) &&
3054 CHECK_AT(parser->buffer, '.', 2))) &&
3055 IS_BLANKZ_AT(parser->buffer, 3))
3057 yaml_parser_set_scanner_error(parser, "while scanning a quoted scalar",
3058 start_mark, "found unexpected document indicator");
3059 goto error;
3062 /* Check for EOF. */
3064 if (IS_Z(parser->buffer)) {
3065 yaml_parser_set_scanner_error(parser, "while scanning a quoted scalar",
3066 start_mark, "found unexpected end of stream");
3067 goto error;
3070 /* Consume non-blank characters. */
3072 if (!CACHE(parser, 2)) goto error;
3074 leading_blanks = 0;
3076 while (!IS_BLANKZ(parser->buffer))
3078 /* Check for an escaped single quote. */
3080 if (single && CHECK_AT(parser->buffer, '\'', 0)
3081 && CHECK_AT(parser->buffer, '\'', 1))
3083 if (!STRING_EXTEND(parser, string)) goto error;
3084 *(string.pointer++) = '\'';
3085 SKIP(parser);
3086 SKIP(parser);
3089 /* Check for the right quote. */
3091 else if (CHECK(parser->buffer, single ? '\'' : '"'))
3093 break;
3096 /* Check for an escaped line break. */
3098 else if (!single && CHECK(parser->buffer, '\\')
3099 && IS_BREAK_AT(parser->buffer, 1))
3101 if (!CACHE(parser, 3)) goto error;
3102 SKIP(parser);
3103 SKIP_LINE(parser);
3104 leading_blanks = 1;
3105 break;
3108 /* Check for an escape sequence. */
3110 else if (!single && CHECK(parser->buffer, '\\'))
3112 size_t code_length = 0;
3114 if (!STRING_EXTEND(parser, string)) goto error;
3116 /* Check the escape character. */
3118 switch (parser->buffer.pointer[1])
3120 case '0':
3121 *(string.pointer++) = '\0';
3122 break;
3124 case 'a':
3125 *(string.pointer++) = '\x07';
3126 break;
3128 case 'b':
3129 *(string.pointer++) = '\x08';
3130 break;
3132 case 't':
3133 case '\t':
3134 *(string.pointer++) = '\x09';
3135 break;
3137 case 'n':
3138 *(string.pointer++) = '\x0A';
3139 break;
3141 case 'v':
3142 *(string.pointer++) = '\x0B';
3143 break;
3145 case 'f':
3146 *(string.pointer++) = '\x0C';
3147 break;
3149 case 'r':
3150 *(string.pointer++) = '\x0D';
3151 break;
3153 case 'e':
3154 *(string.pointer++) = '\x1B';
3155 break;
3157 case ' ':
3158 *(string.pointer++) = '\x20';
3159 break;
3161 case '"':
3162 *(string.pointer++) = '"';
3163 break;
3165 case '\'':
3166 *(string.pointer++) = '\'';
3167 break;
3169 case '\\':
3170 *(string.pointer++) = '\\';
3171 break;
3173 case 'N': /* NEL (#x85) */
3174 *(string.pointer++) = '\xC2';
3175 *(string.pointer++) = '\x85';
3176 break;
3178 case '_': /* #xA0 */
3179 *(string.pointer++) = '\xC2';
3180 *(string.pointer++) = '\xA0';
3181 break;
3183 case 'L': /* LS (#x2028) */
3184 *(string.pointer++) = '\xE2';
3185 *(string.pointer++) = '\x80';
3186 *(string.pointer++) = '\xA8';
3187 break;
3189 case 'P': /* PS (#x2029) */
3190 *(string.pointer++) = '\xE2';
3191 *(string.pointer++) = '\x80';
3192 *(string.pointer++) = '\xA9';
3193 break;
3195 case 'x':
3196 code_length = 2;
3197 break;
3199 case 'u':
3200 code_length = 4;
3201 break;
3203 case 'U':
3204 code_length = 8;
3205 break;
3207 default:
3208 yaml_parser_set_scanner_error(parser, "while parsing a quoted scalar",
3209 start_mark, "found unknown escape character");
3210 goto error;
3213 SKIP(parser);
3214 SKIP(parser);
3216 /* Consume an arbitrary escape code. */
3218 if (code_length)
3220 unsigned int value = 0;
3221 size_t k;
3223 /* Scan the character value. */
3225 if (!CACHE(parser, code_length)) goto error;
3227 for (k = 0; k < code_length; k ++) {
3228 if (!IS_HEX_AT(parser->buffer, k)) {
3229 yaml_parser_set_scanner_error(parser, "while parsing a quoted scalar",
3230 start_mark, "did not find expected hexdecimal number");
3231 goto error;
3233 value = (value << 4) + AS_HEX_AT(parser->buffer, k);
3236 /* Check the value and write the character. */
3238 if ((value >= 0xD800 && value <= 0xDFFF) || value > 0x10FFFF) {
3239 yaml_parser_set_scanner_error(parser, "while parsing a quoted scalar",
3240 start_mark, "found invalid Unicode character escape code");
3241 goto error;
3244 if (value <= 0x7F) {
3245 *(string.pointer++) = value;
3247 else if (value <= 0x7FF) {
3248 *(string.pointer++) = 0xC0 + (value >> 6);
3249 *(string.pointer++) = 0x80 + (value & 0x3F);
3251 else if (value <= 0xFFFF) {
3252 *(string.pointer++) = 0xE0 + (value >> 12);
3253 *(string.pointer++) = 0x80 + ((value >> 6) & 0x3F);
3254 *(string.pointer++) = 0x80 + (value & 0x3F);
3256 else {
3257 *(string.pointer++) = 0xF0 + (value >> 18);
3258 *(string.pointer++) = 0x80 + ((value >> 12) & 0x3F);
3259 *(string.pointer++) = 0x80 + ((value >> 6) & 0x3F);
3260 *(string.pointer++) = 0x80 + (value & 0x3F);
3263 /* Advance the pointer. */
3265 for (k = 0; k < code_length; k ++) {
3266 SKIP(parser);
3271 else
3273 /* It is a non-escaped non-blank character. */
3275 if (!READ(parser, string)) goto error;
3278 if (!CACHE(parser, 2)) goto error;
3281 /* Check if we are at the end of the scalar. */
3283 if (CHECK(parser->buffer, single ? '\'' : '"'))
3284 break;
3286 /* Consume blank characters. */
3288 if (!CACHE(parser, 1)) goto error;
3290 while (IS_BLANK(parser->buffer) || IS_BREAK(parser->buffer))
3292 if (IS_BLANK(parser->buffer))
3294 /* Consume a space or a tab character. */
3296 if (!leading_blanks) {
3297 if (!READ(parser, whitespaces)) goto error;
3299 else {
3300 SKIP(parser);
3303 else
3305 if (!CACHE(parser, 2)) goto error;
3307 /* Check if it is a first line break. */
3309 if (!leading_blanks)
3311 CLEAR(parser, whitespaces);
3312 if (!READ_LINE(parser, leading_break)) goto error;
3313 leading_blanks = 1;
3315 else
3317 if (!READ_LINE(parser, trailing_breaks)) goto error;
3320 if (!CACHE(parser, 1)) goto error;
3323 /* Join the whitespaces or fold line breaks. */
3325 if (leading_blanks)
3327 /* Do we need to fold line breaks? */
3329 if (leading_break.start[0] == '\n') {
3330 if (trailing_breaks.start[0] == '\0') {
3331 if (!STRING_EXTEND(parser, string)) goto error;
3332 *(string.pointer++) = ' ';
3334 else {
3335 if (!JOIN(parser, string, trailing_breaks)) goto error;
3336 CLEAR(parser, trailing_breaks);
3338 CLEAR(parser, leading_break);
3340 else {
3341 if (!JOIN(parser, string, leading_break)) goto error;
3342 if (!JOIN(parser, string, trailing_breaks)) goto error;
3343 CLEAR(parser, leading_break);
3344 CLEAR(parser, trailing_breaks);
3347 else
3349 if (!JOIN(parser, string, whitespaces)) goto error;
3350 CLEAR(parser, whitespaces);
3354 /* Eat the right quote. */
3356 SKIP(parser);
3358 end_mark = parser->mark;
3360 /* Create a token. */
3362 SCALAR_TOKEN_INIT(*token, string.start, string.pointer-string.start,
3363 single ? YAML_SINGLE_QUOTED_SCALAR_STYLE : YAML_DOUBLE_QUOTED_SCALAR_STYLE,
3364 start_mark, end_mark);
3366 STRING_DEL(parser, leading_break);
3367 STRING_DEL(parser, trailing_breaks);
3368 STRING_DEL(parser, whitespaces);
3370 return 1;
3372error:
3373 STRING_DEL(parser, string);
3374 STRING_DEL(parser, leading_break);
3375 STRING_DEL(parser, trailing_breaks);
3376 STRING_DEL(parser, whitespaces);
3378 return 0;
3382 * Scan a plain scalar.
3383 */
3385static int
3386yaml_parser_scan_plain_scalar(yaml_parser_t *parser, yaml_token_t *token)
3388 yaml_mark_t start_mark;
3389 yaml_mark_t end_mark;
3390 yaml_string_t string = NULL_STRING;
3391 yaml_string_t leading_break = NULL_STRING;
3392 yaml_string_t trailing_breaks = NULL_STRING;
3393 yaml_string_t whitespaces = NULL_STRING;
3394 int leading_blanks = 0;
3395 int indent = parser->indent+1;
3397 if (!STRING_INIT(parser, string, INITIAL_STRING_SIZE)) goto error;
3398 if (!STRING_INIT(parser, leading_break, INITIAL_STRING_SIZE)) goto error;
3399 if (!STRING_INIT(parser, trailing_breaks, INITIAL_STRING_SIZE)) goto error;
3400 if (!STRING_INIT(parser, whitespaces, INITIAL_STRING_SIZE)) goto error;
3402 start_mark = end_mark = parser->mark;
3404 /* Consume the content of the plain scalar. */
3406 while (1)
3408 /* Check for a document indicator. */
3410 if (!CACHE(parser, 4)) goto error;
3412 if (parser->mark.column == 0 &&
3413 ((CHECK_AT(parser->buffer, '-', 0) &&
3414 CHECK_AT(parser->buffer, '-', 1) &&
3415 CHECK_AT(parser->buffer, '-', 2)) ||
3416 (CHECK_AT(parser->buffer, '.', 0) &&
3417 CHECK_AT(parser->buffer, '.', 1) &&
3418 CHECK_AT(parser->buffer, '.', 2))) &&
3419 IS_BLANKZ_AT(parser->buffer, 3)) break;
3421 /* Check for a comment. */
3423 if (CHECK(parser->buffer, '#'))
3424 break;
3426 /* Consume non-blank characters. */
3428 while (!IS_BLANKZ(parser->buffer))
3430 /* Check for 'x:x' in the flow context. TODO: Fix the test "spec-08-13". */
3432 if (parser->flow_level
3433 && CHECK(parser->buffer, ':')
3434 && !IS_BLANKZ_AT(parser->buffer, 1)) {
3435 yaml_parser_set_scanner_error(parser, "while scanning a plain scalar",
3436 start_mark, "found unexpected ':'");
3437 goto error;
3440 /* Check for indicators that may end a plain scalar. */
3442 if ((CHECK(parser->buffer, ':') && IS_BLANKZ_AT(parser->buffer, 1))
3443 || (parser->flow_level &&
3444 (CHECK(parser->buffer, ',') || CHECK(parser->buffer, ':')
3445 || CHECK(parser->buffer, '?') || CHECK(parser->buffer, '[')
3446 || CHECK(parser->buffer, ']') || CHECK(parser->buffer, '{')
3447 || CHECK(parser->buffer, '}'))))
3448 break;
3450 /* Check if we need to join whitespaces and breaks. */
3452 if (leading_blanks || whitespaces.start != whitespaces.pointer)
3454 if (leading_blanks)
3456 /* Do we need to fold line breaks? */
3458 if (leading_break.start[0] == '\n') {
3459 if (trailing_breaks.start[0] == '\0') {
3460 if (!STRING_EXTEND(parser, string)) goto error;
3461 *(string.pointer++) = ' ';
3463 else {
3464 if (!JOIN(parser, string, trailing_breaks)) goto error;
3465 CLEAR(parser, trailing_breaks);
3467 CLEAR(parser, leading_break);
3469 else {
3470 if (!JOIN(parser, string, leading_break)) goto error;
3471 if (!JOIN(parser, string, trailing_breaks)) goto error;
3472 CLEAR(parser, leading_break);
3473 CLEAR(parser, trailing_breaks);
3476 leading_blanks = 0;
3478 else
3480 if (!JOIN(parser, string, whitespaces)) goto error;
3481 CLEAR(parser, whitespaces);
3485 /* Copy the character. */
3487 if (!READ(parser, string)) goto error;
3489 end_mark = parser->mark;
3491 if (!CACHE(parser, 2)) goto error;
3494 /* Is it the end? */
3496 if (!(IS_BLANK(parser->buffer) || IS_BREAK(parser->buffer)))
3497 break;
3499 /* Consume blank characters. */
3501 if (!CACHE(parser, 1)) goto error;
3503 while (IS_BLANK(parser->buffer) || IS_BREAK(parser->buffer))
3505 if (IS_BLANK(parser->buffer))
3507 /* Check for tab character that abuse intendation. */
3509 if (leading_blanks && (int)parser->mark.column < indent
3510 && IS_TAB(parser->buffer)) {
3511 yaml_parser_set_scanner_error(parser, "while scanning a plain scalar",
3512 start_mark, "found a tab character that violate intendation");
3513 goto error;
3516 /* Consume a space or a tab character. */
3518 if (!leading_blanks) {
3519 if (!READ(parser, whitespaces)) goto error;
3521 else {
3522 SKIP(parser);
3525 else
3527 if (!CACHE(parser, 2)) goto error;
3529 /* Check if it is a first line break. */
3531 if (!leading_blanks)
3533 CLEAR(parser, whitespaces);
3534 if (!READ_LINE(parser, leading_break)) goto error;
3535 leading_blanks = 1;
3537 else
3539 if (!READ_LINE(parser, trailing_breaks)) goto error;
3542 if (!CACHE(parser, 1)) goto error;
3545 /* Check intendation level. */
3547 if (!parser->flow_level && (int)parser->mark.column < indent)
3548 break;
3551 /* Create a token. */
3553 SCALAR_TOKEN_INIT(*token, string.start, string.pointer-string.start,
3554 YAML_PLAIN_SCALAR_STYLE, start_mark, end_mark);
3556 /* Note that we change the 'simple_key_allowed' flag. */
3558 if (leading_blanks) {
3559 parser->simple_key_allowed = 1;
3562 STRING_DEL(parser, leading_break);
3563 STRING_DEL(parser, trailing_breaks);
3564 STRING_DEL(parser, whitespaces);
3566 return 1;
3568error:
3569 STRING_DEL(parser, string);
3570 STRING_DEL(parser, leading_break);
3571 STRING_DEL(parser, trailing_breaks);
3572 STRING_DEL(parser, whitespaces);
3574 return 0;