]>
Commit | Line | Data |
---|---|---|
0fbeb4dc AK |
1 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
2 | <html xmlns="http://www.w3.org/1999/xhtml"> | |
3 | <head> | |
4 | <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> | |
059850b5 | 5 | <meta http-equiv="X-UA-Compatible" content="IE=9"/> |
b9668ba4 | 6 | <title>yaml: Parser Definitions</title> |
059850b5 | 7 | |
0fbeb4dc | 8 | <link href="tabs.css" rel="stylesheet" type="text/css"/> |
059850b5 AK |
9 | <link href="doxygen.css" rel="stylesheet" type="text/css" /> |
10 | ||
11 | ||
12 | ||
0fbeb4dc AK |
13 | </head> |
14 | <body> | |
059850b5 AK |
15 | <div id="top"><!-- do not remove this div! --> |
16 | ||
17 | ||
18 | <div id="titlearea"> | |
19 | <table cellspacing="0" cellpadding="0"> | |
20 | <tbody> | |
21 | <tr style="height: 56px;"> | |
22 | ||
23 | ||
24 | <td style="padding-left: 0.5em;"> | |
25 | <div id="projectname">yaml | |
26 |  <span id="projectnumber">0.1.5</span> | |
27 | </div> | |
28 | ||
29 | </td> | |
30 | ||
31 | ||
32 | ||
33 | </tr> | |
34 | </tbody> | |
35 | </table> | |
36 | </div> | |
37 | ||
38 | <!-- Generated by Doxygen 1.7.6.1 --> | |
39 | <div id="navrow1" class="tabs"> | |
0fbeb4dc | 40 | <ul class="tablist"> |
059850b5 | 41 | <li><a href="index.html"><span>Main Page</span></a></li> |
5c706339 | 42 | <li><a href="modules.html"><span>Modules</span></a></li> |
059850b5 | 43 | <li><a href="annotated.html"><span>Data Structures</span></a></li> |
5c706339 AK |
44 | <li><a href="files.html"><span>Files</span></a></li> |
45 | </ul> | |
46 | </div> | |
47 | </div> | |
0fbeb4dc AK |
48 | <div class="header"> |
49 | <div class="summary"> | |
50 | <a href="#nested-classes">Data Structures</a> | | |
51 | <a href="#typedef-members">Typedefs</a> | | |
52 | <a href="#enum-members">Enumerations</a> | | |
53 | <a href="#func-members">Functions</a> </div> | |
54 | <div class="headertitle"> | |
059850b5 AK |
55 | <div class="title">Parser Definitions</div> </div> |
56 | </div><!--header--> | |
5c706339 | 57 | <div class="contents"> |
0fbeb4dc AK |
58 | <table class="memberdecls"> |
59 | <tr><td colspan="2"><h2><a name="nested-classes"></a> | |
60 | Data Structures</h2></td></tr> | |
059850b5 AK |
61 | <tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__simple__key__s.html">yaml_simple_key_s</a></td></tr> |
62 | <tr><td class="mdescLeft"> </td><td class="mdescRight">This structure holds information about a potential simple key. <a href="structyaml__simple__key__s.html#details">More...</a><br/></td></tr> | |
63 | <tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__alias__data__s.html">yaml_alias_data_s</a></td></tr> | |
64 | <tr><td class="mdescLeft"> </td><td class="mdescRight">This structure holds aliases data. <a href="structyaml__alias__data__s.html#details">More...</a><br/></td></tr> | |
65 | <tr><td class="memItemLeft" align="right" valign="top">struct  </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__parser__s.html">yaml_parser_s</a></td></tr> | |
66 | <tr><td class="mdescLeft"> </td><td class="mdescRight">The parser structure. <a href="structyaml__parser__s.html#details">More...</a><br/></td></tr> | |
0fbeb4dc AK |
67 | <tr><td colspan="2"><h2><a name="typedef-members"></a> |
68 | Typedefs</h2></td></tr> | |
059850b5 AK |
69 | <tr><td class="memItemLeft" align="right" valign="top">typedef int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga4982f7e4e001ddb47d2819f38f0cd9d6">yaml_read_handler_t</a> (void *data, unsigned char *buffer, size_t size, size_t *size_read)</td></tr> |
70 | <tr><td class="mdescLeft"> </td><td class="mdescRight">The prototype of a read handler. <a href="#ga4982f7e4e001ddb47d2819f38f0cd9d6"></a><br/></td></tr> | |
0fbeb4dc | 71 | <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="gae5570fbb7ab7c8332cd666f3a9c26591"></a><!-- doxytag: member="parser::yaml_simple_key_t" ref="gae5570fbb7ab7c8332cd666f3a9c26591" args="" --> |
059850b5 AK |
72 | typedef struct <a class="el" href="structyaml__simple__key__s.html">yaml_simple_key_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gae5570fbb7ab7c8332cd666f3a9c26591">yaml_simple_key_t</a></td></tr> |
73 | <tr><td class="mdescLeft"> </td><td class="mdescRight">This structure holds information about a potential simple key. <br/></td></tr> | |
0fbeb4dc | 74 | <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga52b56d3e3cee0f9ba460978802a8c83b"></a><!-- doxytag: member="parser::yaml_parser_state_t" ref="ga52b56d3e3cee0f9ba460978802a8c83b" args="" --> |
059850b5 AK |
75 | typedef enum <a class="el" href="group__parser.html#gad39c19e7b0df6f542ca97806535b57c5">yaml_parser_state_e</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga52b56d3e3cee0f9ba460978802a8c83b">yaml_parser_state_t</a></td></tr> |
76 | <tr><td class="mdescLeft"> </td><td class="mdescRight">The states of the parser. <br/></td></tr> | |
0fbeb4dc | 77 | <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ga1434228b82f5f90d3c8ccda816e9ca9d"></a><!-- doxytag: member="parser::yaml_alias_data_t" ref="ga1434228b82f5f90d3c8ccda816e9ca9d" args="" --> |
059850b5 AK |
78 | typedef struct <a class="el" href="structyaml__alias__data__s.html">yaml_alias_data_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga1434228b82f5f90d3c8ccda816e9ca9d">yaml_alias_data_t</a></td></tr> |
79 | <tr><td class="mdescLeft"> </td><td class="mdescRight">This structure holds aliases data. <br/></td></tr> | |
80 | <tr><td class="memItemLeft" align="right" valign="top">typedef struct <a class="el" href="structyaml__parser__s.html">yaml_parser_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a></td></tr> | |
81 | <tr><td class="mdescLeft"> </td><td class="mdescRight">The parser structure. <a href="#gafdc6319cb28a8b8034542b29be85b0c4"></a><br/></td></tr> | |
0fbeb4dc AK |
82 | <tr><td colspan="2"><h2><a name="enum-members"></a> |
83 | Enumerations</h2></td></tr> | |
059850b5 AK |
84 | <tr><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gad39c19e7b0df6f542ca97806535b57c5">yaml_parser_state_e</a> { <br/> |
85 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5ae7b52e16bf002db5cf2944596d8c880e">YAML_PARSE_STREAM_START_STATE</a>, | |
0fbeb4dc | 86 | <br/> |
059850b5 | 87 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a8255725d67d5bd3574fc7df4db1c6c84">YAML_PARSE_IMPLICIT_DOCUMENT_START_STATE</a>, |
0fbeb4dc | 88 | <br/> |
059850b5 | 89 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5aa06d10f700d245caecfc6074a6c52fde">YAML_PARSE_DOCUMENT_START_STATE</a>, |
0fbeb4dc | 90 | <br/> |
059850b5 | 91 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5ae444c7652c8029b0ef80068eaaaa3d4d">YAML_PARSE_DOCUMENT_CONTENT_STATE</a>, |
0fbeb4dc | 92 | <br/> |
059850b5 | 93 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5aeef06d7f13fa4501146a5b9876c98239">YAML_PARSE_DOCUMENT_END_STATE</a>, |
0fbeb4dc | 94 | <br/> |
059850b5 | 95 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5ae1893c0835bacf05cdc21ed181fb75f1">YAML_PARSE_BLOCK_NODE_STATE</a>, |
0fbeb4dc | 96 | <br/> |
059850b5 | 97 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5acbd390af0d3919fe0382d03c284ff3b5">YAML_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE</a>, |
0fbeb4dc | 98 | <br/> |
059850b5 | 99 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a5bb321f9d18c5b208a71c04bbcbd1d01">YAML_PARSE_FLOW_NODE_STATE</a>, |
0fbeb4dc | 100 | <br/> |
059850b5 | 101 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a5bb5f95fc5f1a258ee8e9db0ed25b2d9">YAML_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE</a>, |
0fbeb4dc | 102 | <br/> |
059850b5 | 103 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a8a6cb1f12fe08eee7fc2fa854dbd5b1a">YAML_PARSE_BLOCK_SEQUENCE_ENTRY_STATE</a>, |
0fbeb4dc | 104 | <br/> |
059850b5 | 105 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5af7095f2141cf9887489e832f0ec61fbd">YAML_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE</a>, |
0fbeb4dc | 106 | <br/> |
059850b5 | 107 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5afebcb5bbd67d112d9ecfa633155f0644">YAML_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE</a>, |
0fbeb4dc | 108 | <br/> |
059850b5 | 109 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a2df81c86e90b874b415ecb19e72efe45">YAML_PARSE_BLOCK_MAPPING_KEY_STATE</a>, |
0fbeb4dc | 110 | <br/> |
059850b5 | 111 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5ae94acf5685fa1538b225413f154465c2">YAML_PARSE_BLOCK_MAPPING_VALUE_STATE</a>, |
0fbeb4dc | 112 | <br/> |
059850b5 | 113 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a3f54830989c12cc4a63494df792eeb08">YAML_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE</a>, |
0fbeb4dc | 114 | <br/> |
059850b5 | 115 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a0e50f3841eb0d37ad159e64c4a9a1171">YAML_PARSE_FLOW_SEQUENCE_ENTRY_STATE</a>, |
0fbeb4dc | 116 | <br/> |
059850b5 | 117 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a563e11601cf3a1d2a3efc1feb1b696a3">YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE</a>, |
0fbeb4dc | 118 | <br/> |
059850b5 | 119 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a9e5ebb4bee4541e7a7025689c7fc66eb">YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE</a>, |
0fbeb4dc | 120 | <br/> |
059850b5 | 121 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a397fd87de9227c64e5308481930b5eeb">YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE</a>, |
0fbeb4dc | 122 | <br/> |
059850b5 | 123 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a91ac4bbb6629e2b768a3305fb707b7cd">YAML_PARSE_FLOW_MAPPING_FIRST_KEY_STATE</a>, |
0fbeb4dc | 124 | <br/> |
059850b5 | 125 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a924f8eb891dc7527bf4db594a0b1bff8">YAML_PARSE_FLOW_MAPPING_KEY_STATE</a>, |
0fbeb4dc | 126 | <br/> |
059850b5 | 127 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a3ba351f6cfba029248ada2c0720246d4">YAML_PARSE_FLOW_MAPPING_VALUE_STATE</a>, |
0fbeb4dc | 128 | <br/> |
059850b5 | 129 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a5a8ec0af5c3314c1ad5e0569b6a5d6d2">YAML_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE</a>, |
0fbeb4dc | 130 | <br/> |
059850b5 | 131 |   <a class="el" href="group__parser.html#ggad39c19e7b0df6f542ca97806535b57c5a51fd3d45693e2240251996def375a2a2">YAML_PARSE_END_STATE</a> |
0fbeb4dc | 132 | <br/> |
b9668ba4 | 133 | }</td></tr> |
059850b5 | 134 | <tr><td class="mdescLeft"> </td><td class="mdescRight">The states of the parser. <a href="group__parser.html#gad39c19e7b0df6f542ca97806535b57c5">More...</a><br/></td></tr> |
0fbeb4dc AK |
135 | <tr><td colspan="2"><h2><a name="func-members"></a> |
136 | Functions</h2></td></tr> | |
059850b5 AK |
137 | <tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gacc37ceeb5847e38a3fe24eb0c9b53965">yaml_parser_initialize</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser)</td></tr> |
138 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Initialize a parser. <a href="#gacc37ceeb5847e38a3fe24eb0c9b53965"></a><br/></td></tr> | |
139 | <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gaa27150107c4667c1024ec0651e2ac26b">yaml_parser_delete</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser)</td></tr> | |
140 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Destroy a parser. <a href="#gaa27150107c4667c1024ec0651e2ac26b"></a><br/></td></tr> | |
141 | <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga08a94762bf5f4c61f72c1da0a407df0d">yaml_parser_set_input_string</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, const unsigned char *input, size_t size)</td></tr> | |
142 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a string input. <a href="#ga08a94762bf5f4c61f72c1da0a407df0d"></a><br/></td></tr> | |
143 | <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gac3f00f8beb2365b1e4569692d64696b6">yaml_parser_set_input_file</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, FILE *file)</td></tr> | |
144 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a file input. <a href="#gac3f00f8beb2365b1e4569692d64696b6"></a><br/></td></tr> | |
145 | <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#gabc67581bfa771a3e787d907d6914b8d9">yaml_parser_set_input</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, <a class="el" href="group__parser.html#ga4982f7e4e001ddb47d2819f38f0cd9d6">yaml_read_handler_t</a> *handler, void *data)</td></tr> | |
146 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set a generic input handler. <a href="#gabc67581bfa771a3e787d907d6914b8d9"></a><br/></td></tr> | |
147 | <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga9565b64975570ed34612a19adf02ae6a">yaml_parser_set_encoding</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, <a class="el" href="group__basic.html#ga2170996d7e636397b5e6bc0c1b7df7c6">yaml_encoding_t</a> encoding)</td></tr> | |
148 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Set the source encoding. <a href="#ga9565b64975570ed34612a19adf02ae6a"></a><br/></td></tr> | |
149 | <tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga6c2144f131ebd600a075d4ba654540f7">yaml_parser_scan</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, <a class="el" href="group__tokens.html#ga1ed3dc460e62aee8270c5d63d5734bbb">yaml_token_t</a> *token)</td></tr> | |
150 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Scan the input stream and produce the next token. <a href="#ga6c2144f131ebd600a075d4ba654540f7"></a><br/></td></tr> | |
151 | <tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga559312fb137533d8b7e07f224fe0ec8f">yaml_parser_parse</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, <a class="el" href="group__events.html#ga3b392d9716c4920cabefdd29e78dd542">yaml_event_t</a> *event)</td></tr> | |
152 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Parse the input stream and produce the next parsing event. <a href="#ga559312fb137533d8b7e07f224fe0ec8f"></a><br/></td></tr> | |
153 | <tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__parser.html#ga9ef7d6e9494766b5880c389bc431d138">yaml_parser_load</a> (<a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> *parser, <a class="el" href="group__nodes.html#gad94e064e95baeb22e4f7acc7804e8479">yaml_document_t</a> *document)</td></tr> | |
154 | <tr><td class="mdescLeft"> </td><td class="mdescRight">Parse the input stream and produce the next YAML document. <a href="#ga9ef7d6e9494766b5880c389bc431d138"></a><br/></td></tr> | |
b9668ba4 | 155 | </table> |
0fbeb4dc AK |
156 | <hr/><h2>Typedef Documentation</h2> |
157 | <a class="anchor" id="ga4982f7e4e001ddb47d2819f38f0cd9d6"></a><!-- doxytag: member="yaml.h::yaml_read_handler_t" ref="ga4982f7e4e001ddb47d2819f38f0cd9d6" args="(void *data, unsigned char *buffer, size_t size, size_t *size_read)" --> | |
b9668ba4 AK |
158 | <div class="memitem"> |
159 | <div class="memproto"> | |
160 | <table class="memname"> | |
161 | <tr> | |
0fbeb4dc | 162 | <td class="memname">typedef int <a class="el" href="group__parser.html#ga4982f7e4e001ddb47d2819f38f0cd9d6">yaml_read_handler_t</a>(void *data, unsigned char *buffer, size_t size, size_t *size_read)</td> |
b9668ba4 AK |
163 | </tr> |
164 | </table> | |
165 | </div> | |
166 | <div class="memdoc"> | |
167 | ||
0fbeb4dc AK |
168 | <p>The prototype of a read handler. </p> |
169 | <p>The read handler is called when the parser needs to read more bytes from the source. The handler should write not more than <em>size</em> bytes to the <em>buffer</em>. The number of written bytes should be set to the <em>length</em> variable.</p> | |
059850b5 AK |
170 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
171 | <table class="params"> | |
172 | <tr><td class="paramdir">[in,out]</td><td class="paramname">data</td><td>A pointer to an application data specified by <a class="el" href="group__parser.html#gabc67581bfa771a3e787d907d6914b8d9" title="Set a generic input handler.">yaml_parser_set_input()</a>. </td></tr> | |
173 | <tr><td class="paramdir">[out]</td><td class="paramname">buffer</td><td>The buffer to write the data from the source. </td></tr> | |
174 | <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The size of the buffer. </td></tr> | |
175 | <tr><td class="paramdir">[out]</td><td class="paramname">size_read</td><td>The actual number of bytes read from the source.</td></tr> | |
b9668ba4 | 176 | </table> |
0fbeb4dc | 177 | </dd> |
b9668ba4 | 178 | </dl> |
0fbeb4dc | 179 | <dl class="return"><dt><b>Returns:</b></dt><dd>On success, the handler should return <code>1</code>. If the handler failed, the returned value should be <code>0</code>. On EOF, the handler should set the <em>size_read</em> to <code>0</code> and return <code>1</code>. </dd></dl> |
b9668ba4 AK |
180 | |
181 | </div> | |
0fbeb4dc AK |
182 | </div> |
183 | <a class="anchor" id="gafdc6319cb28a8b8034542b29be85b0c4"></a><!-- doxytag: member="yaml.h::yaml_parser_t" ref="gafdc6319cb28a8b8034542b29be85b0c4" args="" --> | |
b9668ba4 AK |
184 | <div class="memitem"> |
185 | <div class="memproto"> | |
186 | <table class="memname"> | |
187 | <tr> | |
059850b5 | 188 | <td class="memname">typedef struct <a class="el" href="structyaml__parser__s.html">yaml_parser_s</a> <a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a></td> |
b9668ba4 AK |
189 | </tr> |
190 | </table> | |
191 | </div> | |
192 | <div class="memdoc"> | |
193 | ||
0fbeb4dc AK |
194 | <p>The parser structure. </p> |
195 | <p>All members are internal. Manage the structure using the <code>yaml_parser_</code> family of functions. </p> | |
196 | ||
197 | </div> | |
198 | </div> | |
199 | <hr/><h2>Enumeration Type Documentation</h2> | |
200 | <a class="anchor" id="gad39c19e7b0df6f542ca97806535b57c5"></a><!-- doxytag: member="yaml.h::yaml_parser_state_e" ref="gad39c19e7b0df6f542ca97806535b57c5" args="" --> | |
b9668ba4 AK |
201 | <div class="memitem"> |
202 | <div class="memproto"> | |
203 | <table class="memname"> | |
204 | <tr> | |
0fbeb4dc | 205 | <td class="memname">enum <a class="el" href="group__parser.html#gad39c19e7b0df6f542ca97806535b57c5">yaml_parser_state_e</a></td> |
b9668ba4 AK |
206 | </tr> |
207 | </table> | |
208 | </div> | |
209 | <div class="memdoc"> | |
210 | ||
0fbeb4dc AK |
211 | <p>The states of the parser. </p> |
212 | <dl><dt><b>Enumerator: </b></dt><dd><table border="0" cellspacing="2" cellpadding="0"> | |
213 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5ae7b52e16bf002db5cf2944596d8c880e"></a><!-- doxytag: member="YAML_PARSE_STREAM_START_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5ae7b52e16bf002db5cf2944596d8c880e" args="" -->YAML_PARSE_STREAM_START_STATE</em> </td><td> | |
214 | <p>Expect STREAM-START. </p> | |
5c706339 | 215 | </td></tr> |
0fbeb4dc AK |
216 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a8255725d67d5bd3574fc7df4db1c6c84"></a><!-- doxytag: member="YAML_PARSE_IMPLICIT_DOCUMENT_START_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a8255725d67d5bd3574fc7df4db1c6c84" args="" -->YAML_PARSE_IMPLICIT_DOCUMENT_START_STATE</em> </td><td> |
217 | <p>Expect the beginning of an implicit document. </p> | |
5c706339 | 218 | </td></tr> |
0fbeb4dc AK |
219 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5aa06d10f700d245caecfc6074a6c52fde"></a><!-- doxytag: member="YAML_PARSE_DOCUMENT_START_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5aa06d10f700d245caecfc6074a6c52fde" args="" -->YAML_PARSE_DOCUMENT_START_STATE</em> </td><td> |
220 | <p>Expect DOCUMENT-START. </p> | |
5c706339 | 221 | </td></tr> |
0fbeb4dc AK |
222 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5ae444c7652c8029b0ef80068eaaaa3d4d"></a><!-- doxytag: member="YAML_PARSE_DOCUMENT_CONTENT_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5ae444c7652c8029b0ef80068eaaaa3d4d" args="" -->YAML_PARSE_DOCUMENT_CONTENT_STATE</em> </td><td> |
223 | <p>Expect the content of a document. </p> | |
5c706339 | 224 | </td></tr> |
0fbeb4dc AK |
225 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5aeef06d7f13fa4501146a5b9876c98239"></a><!-- doxytag: member="YAML_PARSE_DOCUMENT_END_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5aeef06d7f13fa4501146a5b9876c98239" args="" -->YAML_PARSE_DOCUMENT_END_STATE</em> </td><td> |
226 | <p>Expect DOCUMENT-END. </p> | |
5c706339 | 227 | </td></tr> |
0fbeb4dc AK |
228 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5ae1893c0835bacf05cdc21ed181fb75f1"></a><!-- doxytag: member="YAML_PARSE_BLOCK_NODE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5ae1893c0835bacf05cdc21ed181fb75f1" args="" -->YAML_PARSE_BLOCK_NODE_STATE</em> </td><td> |
229 | <p>Expect a block node. </p> | |
5c706339 | 230 | </td></tr> |
0fbeb4dc AK |
231 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5acbd390af0d3919fe0382d03c284ff3b5"></a><!-- doxytag: member="YAML_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5acbd390af0d3919fe0382d03c284ff3b5" args="" -->YAML_PARSE_BLOCK_NODE_OR_INDENTLESS_SEQUENCE_STATE</em> </td><td> |
232 | <p>Expect a block node or indentless sequence. </p> | |
5c706339 | 233 | </td></tr> |
0fbeb4dc AK |
234 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a5bb321f9d18c5b208a71c04bbcbd1d01"></a><!-- doxytag: member="YAML_PARSE_FLOW_NODE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a5bb321f9d18c5b208a71c04bbcbd1d01" args="" -->YAML_PARSE_FLOW_NODE_STATE</em> </td><td> |
235 | <p>Expect a flow node. </p> | |
5c706339 | 236 | </td></tr> |
0fbeb4dc AK |
237 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a5bb5f95fc5f1a258ee8e9db0ed25b2d9"></a><!-- doxytag: member="YAML_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a5bb5f95fc5f1a258ee8e9db0ed25b2d9" args="" -->YAML_PARSE_BLOCK_SEQUENCE_FIRST_ENTRY_STATE</em> </td><td> |
238 | <p>Expect the first entry of a block sequence. </p> | |
5c706339 | 239 | </td></tr> |
0fbeb4dc AK |
240 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a8a6cb1f12fe08eee7fc2fa854dbd5b1a"></a><!-- doxytag: member="YAML_PARSE_BLOCK_SEQUENCE_ENTRY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a8a6cb1f12fe08eee7fc2fa854dbd5b1a" args="" -->YAML_PARSE_BLOCK_SEQUENCE_ENTRY_STATE</em> </td><td> |
241 | <p>Expect an entry of a block sequence. </p> | |
5c706339 | 242 | </td></tr> |
0fbeb4dc AK |
243 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5af7095f2141cf9887489e832f0ec61fbd"></a><!-- doxytag: member="YAML_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5af7095f2141cf9887489e832f0ec61fbd" args="" -->YAML_PARSE_INDENTLESS_SEQUENCE_ENTRY_STATE</em> </td><td> |
244 | <p>Expect an entry of an indentless sequence. </p> | |
5c706339 | 245 | </td></tr> |
0fbeb4dc AK |
246 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5afebcb5bbd67d112d9ecfa633155f0644"></a><!-- doxytag: member="YAML_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5afebcb5bbd67d112d9ecfa633155f0644" args="" -->YAML_PARSE_BLOCK_MAPPING_FIRST_KEY_STATE</em> </td><td> |
247 | <p>Expect the first key of a block mapping. </p> | |
5c706339 | 248 | </td></tr> |
0fbeb4dc AK |
249 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a2df81c86e90b874b415ecb19e72efe45"></a><!-- doxytag: member="YAML_PARSE_BLOCK_MAPPING_KEY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a2df81c86e90b874b415ecb19e72efe45" args="" -->YAML_PARSE_BLOCK_MAPPING_KEY_STATE</em> </td><td> |
250 | <p>Expect a block mapping key. </p> | |
5c706339 | 251 | </td></tr> |
0fbeb4dc AK |
252 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5ae94acf5685fa1538b225413f154465c2"></a><!-- doxytag: member="YAML_PARSE_BLOCK_MAPPING_VALUE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5ae94acf5685fa1538b225413f154465c2" args="" -->YAML_PARSE_BLOCK_MAPPING_VALUE_STATE</em> </td><td> |
253 | <p>Expect a block mapping value. </p> | |
5c706339 | 254 | </td></tr> |
0fbeb4dc AK |
255 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a3f54830989c12cc4a63494df792eeb08"></a><!-- doxytag: member="YAML_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a3f54830989c12cc4a63494df792eeb08" args="" -->YAML_PARSE_FLOW_SEQUENCE_FIRST_ENTRY_STATE</em> </td><td> |
256 | <p>Expect the first entry of a flow sequence. </p> | |
5c706339 | 257 | </td></tr> |
0fbeb4dc AK |
258 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a0e50f3841eb0d37ad159e64c4a9a1171"></a><!-- doxytag: member="YAML_PARSE_FLOW_SEQUENCE_ENTRY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a0e50f3841eb0d37ad159e64c4a9a1171" args="" -->YAML_PARSE_FLOW_SEQUENCE_ENTRY_STATE</em> </td><td> |
259 | <p>Expect an entry of a flow sequence. </p> | |
5c706339 | 260 | </td></tr> |
0fbeb4dc AK |
261 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a563e11601cf3a1d2a3efc1feb1b696a3"></a><!-- doxytag: member="YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a563e11601cf3a1d2a3efc1feb1b696a3" args="" -->YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_KEY_STATE</em> </td><td> |
262 | <p>Expect a key of an ordered mapping. </p> | |
5c706339 | 263 | </td></tr> |
0fbeb4dc AK |
264 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a9e5ebb4bee4541e7a7025689c7fc66eb"></a><!-- doxytag: member="YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a9e5ebb4bee4541e7a7025689c7fc66eb" args="" -->YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_VALUE_STATE</em> </td><td> |
265 | <p>Expect a value of an ordered mapping. </p> | |
5c706339 | 266 | </td></tr> |
0fbeb4dc AK |
267 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a397fd87de9227c64e5308481930b5eeb"></a><!-- doxytag: member="YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a397fd87de9227c64e5308481930b5eeb" args="" -->YAML_PARSE_FLOW_SEQUENCE_ENTRY_MAPPING_END_STATE</em> </td><td> |
268 | <p>Expect the and of an ordered mapping entry. </p> | |
5c706339 | 269 | </td></tr> |
0fbeb4dc AK |
270 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a91ac4bbb6629e2b768a3305fb707b7cd"></a><!-- doxytag: member="YAML_PARSE_FLOW_MAPPING_FIRST_KEY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a91ac4bbb6629e2b768a3305fb707b7cd" args="" -->YAML_PARSE_FLOW_MAPPING_FIRST_KEY_STATE</em> </td><td> |
271 | <p>Expect the first key of a flow mapping. </p> | |
5c706339 | 272 | </td></tr> |
0fbeb4dc AK |
273 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a924f8eb891dc7527bf4db594a0b1bff8"></a><!-- doxytag: member="YAML_PARSE_FLOW_MAPPING_KEY_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a924f8eb891dc7527bf4db594a0b1bff8" args="" -->YAML_PARSE_FLOW_MAPPING_KEY_STATE</em> </td><td> |
274 | <p>Expect a key of a flow mapping. </p> | |
5c706339 | 275 | </td></tr> |
0fbeb4dc AK |
276 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a3ba351f6cfba029248ada2c0720246d4"></a><!-- doxytag: member="YAML_PARSE_FLOW_MAPPING_VALUE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a3ba351f6cfba029248ada2c0720246d4" args="" -->YAML_PARSE_FLOW_MAPPING_VALUE_STATE</em> </td><td> |
277 | <p>Expect a value of a flow mapping. </p> | |
5c706339 | 278 | </td></tr> |
0fbeb4dc AK |
279 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a5a8ec0af5c3314c1ad5e0569b6a5d6d2"></a><!-- doxytag: member="YAML_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a5a8ec0af5c3314c1ad5e0569b6a5d6d2" args="" -->YAML_PARSE_FLOW_MAPPING_EMPTY_VALUE_STATE</em> </td><td> |
280 | <p>Expect an empty value of a flow mapping. </p> | |
5c706339 | 281 | </td></tr> |
0fbeb4dc AK |
282 | <tr><td valign="top"><em><a class="anchor" id="ggad39c19e7b0df6f542ca97806535b57c5a51fd3d45693e2240251996def375a2a2"></a><!-- doxytag: member="YAML_PARSE_END_STATE" ref="ggad39c19e7b0df6f542ca97806535b57c5a51fd3d45693e2240251996def375a2a2" args="" -->YAML_PARSE_END_STATE</em> </td><td> |
283 | <p>Expect nothing. </p> | |
5c706339 | 284 | </td></tr> |
b9668ba4 | 285 | </table> |
0fbeb4dc | 286 | </dd> |
b9668ba4 AK |
287 | </dl> |
288 | ||
289 | </div> | |
0fbeb4dc AK |
290 | </div> |
291 | <hr/><h2>Function Documentation</h2> | |
292 | <a class="anchor" id="gacc37ceeb5847e38a3fe24eb0c9b53965"></a><!-- doxytag: member="yaml.h::yaml_parser_initialize" ref="gacc37ceeb5847e38a3fe24eb0c9b53965" args="(yaml_parser_t *parser)" --> | |
b9668ba4 AK |
293 | <div class="memitem"> |
294 | <div class="memproto"> | |
295 | <table class="memname"> | |
296 | <tr> | |
059850b5 | 297 | <td class="memname">int <a class="el" href="group__parser.html#gacc37ceeb5847e38a3fe24eb0c9b53965">yaml_parser_initialize</a> </td> |
b9668ba4 | 298 | <td>(</td> |
059850b5 AK |
299 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
300 | <td class="paramname"><em>parser</em></td><td>)</td> | |
5c706339 | 301 | <td></td> |
b9668ba4 AK |
302 | </tr> |
303 | </table> | |
304 | </div> | |
305 | <div class="memdoc"> | |
306 | ||
0fbeb4dc AK |
307 | <p>Initialize a parser. </p> |
308 | <p>This function creates a new parser object. An application is responsible for destroying the object using the <a class="el" href="group__parser.html#gaa27150107c4667c1024ec0651e2ac26b" title="Destroy a parser.">yaml_parser_delete()</a> function.</p> | |
059850b5 AK |
309 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
310 | <table class="params"> | |
311 | <tr><td class="paramdir">[out]</td><td class="paramname">parser</td><td>An empty parser object.</td></tr> | |
b9668ba4 | 312 | </table> |
0fbeb4dc | 313 | </dd> |
b9668ba4 | 314 | </dl> |
0fbeb4dc | 315 | <dl class="return"><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl> |
b9668ba4 AK |
316 | |
317 | </div> | |
0fbeb4dc AK |
318 | </div> |
319 | <a class="anchor" id="gaa27150107c4667c1024ec0651e2ac26b"></a><!-- doxytag: member="yaml.h::yaml_parser_delete" ref="gaa27150107c4667c1024ec0651e2ac26b" args="(yaml_parser_t *parser)" --> | |
b9668ba4 AK |
320 | <div class="memitem"> |
321 | <div class="memproto"> | |
322 | <table class="memname"> | |
323 | <tr> | |
059850b5 | 324 | <td class="memname">void <a class="el" href="group__parser.html#gaa27150107c4667c1024ec0651e2ac26b">yaml_parser_delete</a> </td> |
b9668ba4 | 325 | <td>(</td> |
059850b5 AK |
326 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
327 | <td class="paramname"><em>parser</em></td><td>)</td> | |
5c706339 | 328 | <td></td> |
b9668ba4 AK |
329 | </tr> |
330 | </table> | |
331 | </div> | |
332 | <div class="memdoc"> | |
333 | ||
0fbeb4dc | 334 | <p>Destroy a parser. </p> |
059850b5 AK |
335 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
336 | <table class="params"> | |
337 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
b9668ba4 | 338 | </table> |
0fbeb4dc | 339 | </dd> |
b9668ba4 AK |
340 | </dl> |
341 | ||
342 | </div> | |
0fbeb4dc AK |
343 | </div> |
344 | <a class="anchor" id="ga08a94762bf5f4c61f72c1da0a407df0d"></a><!-- doxytag: member="yaml.h::yaml_parser_set_input_string" ref="ga08a94762bf5f4c61f72c1da0a407df0d" args="(yaml_parser_t *parser, const unsigned char *input, size_t size)" --> | |
b9668ba4 AK |
345 | <div class="memitem"> |
346 | <div class="memproto"> | |
347 | <table class="memname"> | |
348 | <tr> | |
059850b5 | 349 | <td class="memname">void <a class="el" href="group__parser.html#ga08a94762bf5f4c61f72c1da0a407df0d">yaml_parser_set_input_string</a> </td> |
b9668ba4 | 350 | <td>(</td> |
059850b5 AK |
351 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
352 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
353 | </tr> |
354 | <tr> | |
355 | <td class="paramkey"></td> | |
356 | <td></td> | |
059850b5 AK |
357 | <td class="paramtype">const unsigned char * </td> |
358 | <td class="paramname"><em>input</em>, </td> | |
b9668ba4 AK |
359 | </tr> |
360 | <tr> | |
361 | <td class="paramkey"></td> | |
362 | <td></td> | |
059850b5 AK |
363 | <td class="paramtype">size_t </td> |
364 | <td class="paramname"><em>size</em> </td> | |
b9668ba4 AK |
365 | </tr> |
366 | <tr> | |
367 | <td></td> | |
368 | <td>)</td> | |
059850b5 | 369 | <td></td><td></td> |
b9668ba4 AK |
370 | </tr> |
371 | </table> | |
372 | </div> | |
373 | <div class="memdoc"> | |
374 | ||
0fbeb4dc AK |
375 | <p>Set a string input. </p> |
376 | <p>Note that the <em>input</em> pointer must be valid while the <em>parser</em> object exists. The application is responsible for destroing <em>input</em> after destroying the <em>parser</em>.</p> | |
059850b5 AK |
377 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
378 | <table class="params"> | |
379 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
380 | <tr><td class="paramdir">[in]</td><td class="paramname">input</td><td>A source data. </td></tr> | |
381 | <tr><td class="paramdir">[in]</td><td class="paramname">size</td><td>The length of the source data in bytes. </td></tr> | |
b9668ba4 | 382 | </table> |
0fbeb4dc | 383 | </dd> |
b9668ba4 AK |
384 | </dl> |
385 | ||
386 | </div> | |
0fbeb4dc AK |
387 | </div> |
388 | <a class="anchor" id="gac3f00f8beb2365b1e4569692d64696b6"></a><!-- doxytag: member="yaml.h::yaml_parser_set_input_file" ref="gac3f00f8beb2365b1e4569692d64696b6" args="(yaml_parser_t *parser, FILE *file)" --> | |
b9668ba4 AK |
389 | <div class="memitem"> |
390 | <div class="memproto"> | |
391 | <table class="memname"> | |
392 | <tr> | |
059850b5 | 393 | <td class="memname">void <a class="el" href="group__parser.html#gac3f00f8beb2365b1e4569692d64696b6">yaml_parser_set_input_file</a> </td> |
b9668ba4 | 394 | <td>(</td> |
059850b5 AK |
395 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
396 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
397 | </tr> |
398 | <tr> | |
399 | <td class="paramkey"></td> | |
400 | <td></td> | |
059850b5 AK |
401 | <td class="paramtype">FILE * </td> |
402 | <td class="paramname"><em>file</em> </td> | |
b9668ba4 AK |
403 | </tr> |
404 | <tr> | |
405 | <td></td> | |
406 | <td>)</td> | |
059850b5 | 407 | <td></td><td></td> |
b9668ba4 AK |
408 | </tr> |
409 | </table> | |
410 | </div> | |
411 | <div class="memdoc"> | |
412 | ||
0fbeb4dc AK |
413 | <p>Set a file input. </p> |
414 | <p><em>file</em> should be a file object open for reading. The application is responsible for closing the <em>file</em>.</p> | |
059850b5 AK |
415 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
416 | <table class="params"> | |
417 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
418 | <tr><td class="paramdir">[in]</td><td class="paramname">file</td><td>An open file. </td></tr> | |
b9668ba4 | 419 | </table> |
0fbeb4dc | 420 | </dd> |
b9668ba4 AK |
421 | </dl> |
422 | ||
423 | </div> | |
0fbeb4dc AK |
424 | </div> |
425 | <a class="anchor" id="gabc67581bfa771a3e787d907d6914b8d9"></a><!-- doxytag: member="yaml.h::yaml_parser_set_input" ref="gabc67581bfa771a3e787d907d6914b8d9" args="(yaml_parser_t *parser, yaml_read_handler_t *handler, void *data)" --> | |
b9668ba4 AK |
426 | <div class="memitem"> |
427 | <div class="memproto"> | |
428 | <table class="memname"> | |
429 | <tr> | |
059850b5 | 430 | <td class="memname">void <a class="el" href="group__parser.html#gabc67581bfa771a3e787d907d6914b8d9">yaml_parser_set_input</a> </td> |
b9668ba4 | 431 | <td>(</td> |
059850b5 AK |
432 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
433 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
434 | </tr> |
435 | <tr> | |
436 | <td class="paramkey"></td> | |
437 | <td></td> | |
059850b5 AK |
438 | <td class="paramtype"><a class="el" href="group__parser.html#ga4982f7e4e001ddb47d2819f38f0cd9d6">yaml_read_handler_t</a> * </td> |
439 | <td class="paramname"><em>handler</em>, </td> | |
b9668ba4 AK |
440 | </tr> |
441 | <tr> | |
442 | <td class="paramkey"></td> | |
443 | <td></td> | |
059850b5 AK |
444 | <td class="paramtype">void * </td> |
445 | <td class="paramname"><em>data</em> </td> | |
b9668ba4 AK |
446 | </tr> |
447 | <tr> | |
448 | <td></td> | |
449 | <td>)</td> | |
059850b5 | 450 | <td></td><td></td> |
b9668ba4 AK |
451 | </tr> |
452 | </table> | |
453 | </div> | |
454 | <div class="memdoc"> | |
455 | ||
0fbeb4dc | 456 | <p>Set a generic input handler. </p> |
059850b5 AK |
457 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
458 | <table class="params"> | |
459 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
460 | <tr><td class="paramdir">[in]</td><td class="paramname">handler</td><td>A read handler. </td></tr> | |
461 | <tr><td class="paramdir">[in]</td><td class="paramname">data</td><td>Any application data for passing to the read handler. </td></tr> | |
b9668ba4 | 462 | </table> |
0fbeb4dc | 463 | </dd> |
b9668ba4 AK |
464 | </dl> |
465 | ||
466 | </div> | |
0fbeb4dc AK |
467 | </div> |
468 | <a class="anchor" id="ga9565b64975570ed34612a19adf02ae6a"></a><!-- doxytag: member="yaml.h::yaml_parser_set_encoding" ref="ga9565b64975570ed34612a19adf02ae6a" args="(yaml_parser_t *parser, yaml_encoding_t encoding)" --> | |
b9668ba4 AK |
469 | <div class="memitem"> |
470 | <div class="memproto"> | |
471 | <table class="memname"> | |
472 | <tr> | |
059850b5 | 473 | <td class="memname">void <a class="el" href="group__parser.html#ga9565b64975570ed34612a19adf02ae6a">yaml_parser_set_encoding</a> </td> |
b9668ba4 | 474 | <td>(</td> |
059850b5 AK |
475 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
476 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
477 | </tr> |
478 | <tr> | |
479 | <td class="paramkey"></td> | |
480 | <td></td> | |
059850b5 AK |
481 | <td class="paramtype"><a class="el" href="group__basic.html#ga2170996d7e636397b5e6bc0c1b7df7c6">yaml_encoding_t</a> </td> |
482 | <td class="paramname"><em>encoding</em> </td> | |
b9668ba4 AK |
483 | </tr> |
484 | <tr> | |
485 | <td></td> | |
486 | <td>)</td> | |
059850b5 | 487 | <td></td><td></td> |
b9668ba4 AK |
488 | </tr> |
489 | </table> | |
490 | </div> | |
491 | <div class="memdoc"> | |
492 | ||
0fbeb4dc | 493 | <p>Set the source encoding. </p> |
059850b5 AK |
494 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
495 | <table class="params"> | |
496 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
497 | <tr><td class="paramdir">[in]</td><td class="paramname">encoding</td><td>The source encoding. </td></tr> | |
b9668ba4 | 498 | </table> |
0fbeb4dc | 499 | </dd> |
b9668ba4 AK |
500 | </dl> |
501 | ||
502 | </div> | |
0fbeb4dc AK |
503 | </div> |
504 | <a class="anchor" id="ga6c2144f131ebd600a075d4ba654540f7"></a><!-- doxytag: member="yaml.h::yaml_parser_scan" ref="ga6c2144f131ebd600a075d4ba654540f7" args="(yaml_parser_t *parser, yaml_token_t *token)" --> | |
b9668ba4 AK |
505 | <div class="memitem"> |
506 | <div class="memproto"> | |
507 | <table class="memname"> | |
508 | <tr> | |
059850b5 | 509 | <td class="memname">int <a class="el" href="group__parser.html#ga6c2144f131ebd600a075d4ba654540f7">yaml_parser_scan</a> </td> |
b9668ba4 | 510 | <td>(</td> |
059850b5 AK |
511 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
512 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
513 | </tr> |
514 | <tr> | |
515 | <td class="paramkey"></td> | |
516 | <td></td> | |
059850b5 AK |
517 | <td class="paramtype"><a class="el" href="group__tokens.html#ga1ed3dc460e62aee8270c5d63d5734bbb">yaml_token_t</a> * </td> |
518 | <td class="paramname"><em>token</em> </td> | |
b9668ba4 AK |
519 | </tr> |
520 | <tr> | |
521 | <td></td> | |
522 | <td>)</td> | |
059850b5 | 523 | <td></td><td></td> |
b9668ba4 AK |
524 | </tr> |
525 | </table> | |
526 | </div> | |
527 | <div class="memdoc"> | |
528 | ||
0fbeb4dc AK |
529 | <p>Scan the input stream and produce the next token. </p> |
530 | <p>Call the function subsequently to produce a sequence of tokens corresponding to the input stream. The initial token has the type <code>YAML_STREAM_START_TOKEN</code> while the ending token has the type <code>YAML_STREAM_END_TOKEN</code>.</p> | |
531 | <p>An application is responsible for freeing any buffers associated with the produced token object using the <code>yaml_token_delete</code> function.</p> | |
532 | <p>An application must not alternate the calls of <a class="el" href="group__parser.html#ga6c2144f131ebd600a075d4ba654540f7" title="Scan the input stream and produce the next token.">yaml_parser_scan()</a> with the calls of <a class="el" href="group__parser.html#ga559312fb137533d8b7e07f224fe0ec8f" title="Parse the input stream and produce the next parsing event.">yaml_parser_parse()</a> or <a class="el" href="group__parser.html#ga9ef7d6e9494766b5880c389bc431d138" title="Parse the input stream and produce the next YAML document.">yaml_parser_load()</a>. Doing this will break the parser.</p> | |
059850b5 AK |
533 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
534 | <table class="params"> | |
535 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
536 | <tr><td class="paramdir">[out]</td><td class="paramname">token</td><td>An empty token object.</td></tr> | |
b9668ba4 | 537 | </table> |
0fbeb4dc | 538 | </dd> |
b9668ba4 | 539 | </dl> |
0fbeb4dc | 540 | <dl class="return"><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl> |
b9668ba4 AK |
541 | |
542 | </div> | |
0fbeb4dc AK |
543 | </div> |
544 | <a class="anchor" id="ga559312fb137533d8b7e07f224fe0ec8f"></a><!-- doxytag: member="yaml.h::yaml_parser_parse" ref="ga559312fb137533d8b7e07f224fe0ec8f" args="(yaml_parser_t *parser, yaml_event_t *event)" --> | |
b9668ba4 AK |
545 | <div class="memitem"> |
546 | <div class="memproto"> | |
547 | <table class="memname"> | |
548 | <tr> | |
059850b5 | 549 | <td class="memname">int <a class="el" href="group__parser.html#ga559312fb137533d8b7e07f224fe0ec8f">yaml_parser_parse</a> </td> |
b9668ba4 | 550 | <td>(</td> |
059850b5 AK |
551 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
552 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
553 | </tr> |
554 | <tr> | |
555 | <td class="paramkey"></td> | |
556 | <td></td> | |
059850b5 AK |
557 | <td class="paramtype"><a class="el" href="group__events.html#ga3b392d9716c4920cabefdd29e78dd542">yaml_event_t</a> * </td> |
558 | <td class="paramname"><em>event</em> </td> | |
b9668ba4 AK |
559 | </tr> |
560 | <tr> | |
561 | <td></td> | |
562 | <td>)</td> | |
059850b5 | 563 | <td></td><td></td> |
b9668ba4 AK |
564 | </tr> |
565 | </table> | |
566 | </div> | |
567 | <div class="memdoc"> | |
568 | ||
0fbeb4dc AK |
569 | <p>Parse the input stream and produce the next parsing event. </p> |
570 | <p>Call the function subsequently to produce a sequence of events corresponding to the input stream. The initial event has the type <code>YAML_STREAM_START_EVENT</code> while the ending event has the type <code>YAML_STREAM_END_EVENT</code>.</p> | |
571 | <p>An application is responsible for freeing any buffers associated with the produced event object using the <a class="el" href="group__events.html#ga5330d62ef52856aa53188137cb93a6a1" title="Free any memory allocated for an event object.">yaml_event_delete()</a> function.</p> | |
572 | <p>An application must not alternate the calls of <a class="el" href="group__parser.html#ga559312fb137533d8b7e07f224fe0ec8f" title="Parse the input stream and produce the next parsing event.">yaml_parser_parse()</a> with the calls of <a class="el" href="group__parser.html#ga6c2144f131ebd600a075d4ba654540f7" title="Scan the input stream and produce the next token.">yaml_parser_scan()</a> or <a class="el" href="group__parser.html#ga9ef7d6e9494766b5880c389bc431d138" title="Parse the input stream and produce the next YAML document.">yaml_parser_load()</a>. Doing this will break the parser.</p> | |
059850b5 AK |
573 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
574 | <table class="params"> | |
575 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
576 | <tr><td class="paramdir">[out]</td><td class="paramname">event</td><td>An empty event object.</td></tr> | |
b9668ba4 | 577 | </table> |
0fbeb4dc | 578 | </dd> |
b9668ba4 | 579 | </dl> |
0fbeb4dc | 580 | <dl class="return"><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl> |
b9668ba4 AK |
581 | |
582 | </div> | |
0fbeb4dc AK |
583 | </div> |
584 | <a class="anchor" id="ga9ef7d6e9494766b5880c389bc431d138"></a><!-- doxytag: member="yaml.h::yaml_parser_load" ref="ga9ef7d6e9494766b5880c389bc431d138" args="(yaml_parser_t *parser, yaml_document_t *document)" --> | |
b9668ba4 AK |
585 | <div class="memitem"> |
586 | <div class="memproto"> | |
587 | <table class="memname"> | |
588 | <tr> | |
059850b5 | 589 | <td class="memname">int <a class="el" href="group__parser.html#ga9ef7d6e9494766b5880c389bc431d138">yaml_parser_load</a> </td> |
b9668ba4 | 590 | <td>(</td> |
059850b5 AK |
591 | <td class="paramtype"><a class="el" href="group__parser.html#gafdc6319cb28a8b8034542b29be85b0c4">yaml_parser_t</a> * </td> |
592 | <td class="paramname"><em>parser</em>, </td> | |
b9668ba4 AK |
593 | </tr> |
594 | <tr> | |
595 | <td class="paramkey"></td> | |
596 | <td></td> | |
059850b5 AK |
597 | <td class="paramtype"><a class="el" href="group__nodes.html#gad94e064e95baeb22e4f7acc7804e8479">yaml_document_t</a> * </td> |
598 | <td class="paramname"><em>document</em> </td> | |
b9668ba4 AK |
599 | </tr> |
600 | <tr> | |
601 | <td></td> | |
602 | <td>)</td> | |
059850b5 | 603 | <td></td><td></td> |
b9668ba4 AK |
604 | </tr> |
605 | </table> | |
606 | </div> | |
607 | <div class="memdoc"> | |
608 | ||
0fbeb4dc AK |
609 | <p>Parse the input stream and produce the next YAML document. </p> |
610 | <p>Call this function subsequently to produce a sequence of documents constituting the input stream.</p> | |
611 | <p>If the produced document has no root node, it means that the document end has been reached.</p> | |
612 | <p>An application is responsible for freeing any data associated with the produced document object using the <a class="el" href="group__nodes.html#ga2754b1544fb4e110e83fafbc708b0672" title="Delete a YAML document and all its nodes.">yaml_document_delete()</a> function.</p> | |
613 | <p>An application must not alternate the calls of <a class="el" href="group__parser.html#ga9ef7d6e9494766b5880c389bc431d138" title="Parse the input stream and produce the next YAML document.">yaml_parser_load()</a> with the calls of <a class="el" href="group__parser.html#ga6c2144f131ebd600a075d4ba654540f7" title="Scan the input stream and produce the next token.">yaml_parser_scan()</a> or <a class="el" href="group__parser.html#ga559312fb137533d8b7e07f224fe0ec8f" title="Parse the input stream and produce the next parsing event.">yaml_parser_parse()</a>. Doing this will break the parser.</p> | |
059850b5 AK |
614 | <dl class="params"><dt><b>Parameters:</b></dt><dd> |
615 | <table class="params"> | |
616 | <tr><td class="paramdir">[in,out]</td><td class="paramname">parser</td><td>A parser object. </td></tr> | |
617 | <tr><td class="paramdir">[out]</td><td class="paramname">document</td><td>An empty document object.</td></tr> | |
b9668ba4 | 618 | </table> |
0fbeb4dc | 619 | </dd> |
b9668ba4 | 620 | </dl> |
0fbeb4dc | 621 | <dl class="return"><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl> |
b9668ba4 AK |
622 | |
623 | </div> | |
5c706339 | 624 | </div> |
059850b5 AK |
625 | </div><!-- contents --> |
626 | ||
627 | ||
628 | <hr class="footer"/><address class="footer"><small> | |
629 | Generated on Sun Jan 12 2014 18:25:30 for yaml by  <a href="http://www.doxygen.org/index.html"> | |
630 | <img class="footer" src="doxygen.png" alt="doxygen"/> | |
631 | </a> 1.7.6.1 | |
632 | </small></address> | |
633 | ||
b9668ba4 AK |
634 | </body> |
635 | </html> |