1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3 <title>yaml: Nodes</title>
4 <link href="tabs.css" rel="stylesheet" type="text/css">
5 <link href="doxygen.css" rel="stylesheet" type="text/css">
7 <!-- Generated by Doxygen 1.5.8 -->
8 <div class="navigation" id="top">
11 <li><a href="index.html"><span>Main Page</span></a></li>
12 <li><a href="modules.html"><span>Modules</span></a></li>
13 <li><a href="annotated.html"><span>Data Structures</span></a></li>
14 <li><a href="files.html"><span>Files</span></a></li>
18 <div class="contents">
19 <h1>Nodes</h1><table border="0" cellpadding="0" cellspacing="0">
21 <tr><td colspan="2"><br><h2>Data Structures</h2></td></tr>
22 <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__node__pair__s.html">yaml_node_pair_s</a></td></tr>
24 <tr><td class="mdescLeft"> </td><td class="mdescRight">An element of a mapping node. <a href="structyaml__node__pair__s.html#_details">More...</a><br></td></tr>
25 <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__node__s.html">yaml_node_s</a></td></tr>
27 <tr><td class="mdescLeft"> </td><td class="mdescRight">The node structure. <a href="structyaml__node__s.html#_details">More...</a><br></td></tr>
28 <tr><td class="memItemLeft" nowrap align="right" valign="top">struct </td><td class="memItemRight" valign="bottom"><a class="el" href="structyaml__document__s.html">yaml_document_s</a></td></tr>
30 <tr><td class="mdescLeft"> </td><td class="mdescRight">The document structure. <a href="structyaml__document__s.html#_details">More...</a><br></td></tr>
31 <tr><td colspan="2"><br><h2>Defines</h2></td></tr>
32 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gdfa882b6e42a3a993d12392d55260b00">YAML_NULL_TAG</a> "tag:yaml.org,2002:null"</td></tr>
34 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!null</code> with the only possible value: <code>null</code>. <a href="#gdfa882b6e42a3a993d12392d55260b00"></a><br></td></tr>
35 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g312629a1f51e91b136352db988d4d771">YAML_BOOL_TAG</a> "tag:yaml.org,2002:bool"</td></tr>
37 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!bool</code> with the values: <code>true</code> and <code>falce</code>. <a href="#g312629a1f51e91b136352db988d4d771"></a><br></td></tr>
38 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gc5dbc6d1f556663edf8db88d6113e931">YAML_STR_TAG</a> "tag:yaml.org,2002:str"</td></tr>
40 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!str</code> for string values. <a href="#gc5dbc6d1f556663edf8db88d6113e931"></a><br></td></tr>
41 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g83263cdb4ffa6ad2f7d9a87281979ff5">YAML_INT_TAG</a> "tag:yaml.org,2002:int"</td></tr>
43 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!int</code> for integer values. <a href="#g83263cdb4ffa6ad2f7d9a87281979ff5"></a><br></td></tr>
44 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g6ab2ec71fc47cb24f1003b9acdb92843">YAML_FLOAT_TAG</a> "tag:yaml.org,2002:float"</td></tr>
46 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!float</code> for float values. <a href="#g6ab2ec71fc47cb24f1003b9acdb92843"></a><br></td></tr>
47 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g3e27cca7191234f2e8c95eaf3bc99a73">YAML_TIMESTAMP_TAG</a> "tag:yaml.org,2002:timestamp"</td></tr>
49 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!timestamp</code> for date and time values. <a href="#g3e27cca7191234f2e8c95eaf3bc99a73"></a><br></td></tr>
50 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#ga8284b30f9c9e3f10f6a69c9b882f417">YAML_SEQ_TAG</a> "tag:yaml.org,2002:seq"</td></tr>
52 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!seq</code> is used to denote sequences. <a href="#ga8284b30f9c9e3f10f6a69c9b882f417"></a><br></td></tr>
53 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g22ae99cf3ac014dd76873268fd068c12">YAML_MAP_TAG</a> "tag:yaml.org,2002:map"</td></tr>
55 <tr><td class="mdescLeft"> </td><td class="mdescRight">The tag <code>!!map</code> is used to denote mapping. <a href="#g22ae99cf3ac014dd76873268fd068c12"></a><br></td></tr>
56 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gf6b0c4e819b8f6915515a4f70065aaaa">YAML_DEFAULT_SCALAR_TAG</a> YAML_STR_TAG</td></tr>
58 <tr><td class="mdescLeft"> </td><td class="mdescRight">The default scalar tag is <code>!!str</code>. <a href="#gf6b0c4e819b8f6915515a4f70065aaaa"></a><br></td></tr>
59 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gf195b67002518702e27746d6b4da6124">YAML_DEFAULT_SEQUENCE_TAG</a> YAML_SEQ_TAG</td></tr>
61 <tr><td class="mdescLeft"> </td><td class="mdescRight">The default sequence tag is <code>!!seq</code>. <a href="#gf195b67002518702e27746d6b4da6124"></a><br></td></tr>
62 <tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gf7b1f8f0ce5665794510cd3841802a5f">YAML_DEFAULT_MAPPING_TAG</a> YAML_MAP_TAG</td></tr>
64 <tr><td class="mdescLeft"> </td><td class="mdescRight">The default mapping tag is <code>!!map</code>. <a href="#gf7b1f8f0ce5665794510cd3841802a5f"></a><br></td></tr>
65 <tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
66 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef enum <a class="el" href="group__nodes.html#g0897d4b6bdd1b56c7a5fa0ff17b4f798">yaml_node_type_e</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gbe020d2fc42d3e896549e9f97da622d2">yaml_node_type_t</a></td></tr>
68 <tr><td class="mdescLeft"> </td><td class="mdescRight">Node types. <a href="#gbe020d2fc42d3e896549e9f97da622d2"></a><br></td></tr>
69 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="structyaml__node__s.html">yaml_node_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g9eaaa233b120b9d9db47de93c294c40f">yaml_node_t</a></td></tr>
71 <tr><td class="mdescLeft"> </td><td class="mdescRight">The forward definition of a document node structure. <a href="#g9eaaa233b120b9d9db47de93c294c40f"></a><br></td></tr>
72 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g7cc3581582e778b00c04e99cd3656860">yaml_node_item_t</a></td></tr>
74 <tr><td class="mdescLeft"> </td><td class="mdescRight">An element of a sequence node. <a href="#g7cc3581582e778b00c04e99cd3656860"></a><br></td></tr>
75 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="structyaml__node__pair__s.html">yaml_node_pair_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g90f1c8b83c5c38dc4016afc1cc2050c4">yaml_node_pair_t</a></td></tr>
77 <tr><td class="mdescLeft"> </td><td class="mdescRight">An element of a mapping node. <a href="#g90f1c8b83c5c38dc4016afc1cc2050c4"></a><br></td></tr>
78 <tr><td class="memItemLeft" nowrap align="right" valign="top">typedef struct <a class="el" href="structyaml__document__s.html">yaml_document_s</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gd94e064e95baeb22e4f7acc7804e8479">yaml_document_t</a></td></tr>
80 <tr><td class="mdescLeft"> </td><td class="mdescRight">The document structure. <a href="#gd94e064e95baeb22e4f7acc7804e8479"></a><br></td></tr>
81 <tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
82 <tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g0897d4b6bdd1b56c7a5fa0ff17b4f798">yaml_node_type_e</a> { <br>
83 <a class="el" href="group__nodes.html#gg0897d4b6bdd1b56c7a5fa0ff17b4f7980fa87c0e89c4d4136cb47165e6917739">YAML_NO_NODE</a>,
85 <a class="el" href="group__nodes.html#gg0897d4b6bdd1b56c7a5fa0ff17b4f798413ec8ce6b728c9ace703d194b370a45">YAML_SCALAR_NODE</a>,
87 <a class="el" href="group__nodes.html#gg0897d4b6bdd1b56c7a5fa0ff17b4f7986c03b52f7ee737982eac5e4001faac15">YAML_SEQUENCE_NODE</a>,
89 <a class="el" href="group__nodes.html#gg0897d4b6bdd1b56c7a5fa0ff17b4f798c1a08580e3a70973583fc85e3e097ee6">YAML_MAPPING_NODE</a>
93 <tr><td class="mdescLeft"> </td><td class="mdescRight">Node types. <a href="group__nodes.html#g0897d4b6bdd1b56c7a5fa0ff17b4f798">More...</a><br></td></tr>
94 <tr><td colspan="2"><br><h2>Functions</h2></td></tr>
95 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g62a485c96f3b7962436a0da5e6f3cc89">yaml_document_initialize</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, <a class="el" href="structyaml__version__directive__s.html">yaml_version_directive_t</a> *version_directive, <a class="el" href="structyaml__tag__directive__s.html">yaml_tag_directive_t</a> *tag_directives_start, <a class="el" href="structyaml__tag__directive__s.html">yaml_tag_directive_t</a> *tag_directives_end, int start_implicit, int end_implicit)</td></tr>
97 <tr><td class="mdescLeft"> </td><td class="mdescRight">Create a YAML document. <a href="#g62a485c96f3b7962436a0da5e6f3cc89"></a><br></td></tr>
98 <tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g2754b1544fb4e110e83fafbc708b0672">yaml_document_delete</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document)</td></tr>
100 <tr><td class="mdescLeft"> </td><td class="mdescRight">Delete a YAML document and all its nodes. <a href="#g2754b1544fb4e110e83fafbc708b0672"></a><br></td></tr>
101 <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structyaml__node__s.html">yaml_node_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#gfa1feabc9747dbded4dca24e27d3c21a">yaml_document_get_node</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, int index)</td></tr>
103 <tr><td class="mdescLeft"> </td><td class="mdescRight">Get a node of a YAML document. <a href="#gfa1feabc9747dbded4dca24e27d3c21a"></a><br></td></tr>
104 <tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="structyaml__node__s.html">yaml_node_t</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g40eeaa68fb2f3be34c4fe34e7597d324">yaml_document_get_root_node</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document)</td></tr>
106 <tr><td class="mdescLeft"> </td><td class="mdescRight">Get the root of a YAML document node. <a href="#g40eeaa68fb2f3be34c4fe34e7597d324"></a><br></td></tr>
107 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g45dab8b983b58a005557d4b01f5057b0">yaml_document_add_scalar</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, <a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> *tag, <a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> *value, int length, <a class="el" href="group__styles.html#g3fa6405631e1afe5bd5c488a6c5e8065">yaml_scalar_style_t</a> style)</td></tr>
109 <tr><td class="mdescLeft"> </td><td class="mdescRight">Create a SCALAR node and attach it to the document. <a href="#g45dab8b983b58a005557d4b01f5057b0"></a><br></td></tr>
110 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g83b2f7fdd9a439397a42016bddad7786">yaml_document_add_sequence</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, <a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> *tag, <a class="el" href="group__styles.html#g58a1123d271e56c72de6abf852ac4dc2">yaml_sequence_style_t</a> style)</td></tr>
112 <tr><td class="mdescLeft"> </td><td class="mdescRight">Create a SEQUENCE node and attach it to the document. <a href="#g83b2f7fdd9a439397a42016bddad7786"></a><br></td></tr>
113 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g45a9f8288704f99cd81dc5cb31329d34">yaml_document_add_mapping</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, <a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> *tag, <a class="el" href="group__styles.html#gb47523846a5c5960e07367a28ea9750a">yaml_mapping_style_t</a> style)</td></tr>
115 <tr><td class="mdescLeft"> </td><td class="mdescRight">Create a MAPPING node and attach it to the document. <a href="#g45a9f8288704f99cd81dc5cb31329d34"></a><br></td></tr>
116 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g16435917cd6c0261cd390fa8cf173b1b">yaml_document_append_sequence_item</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, int sequence, int item)</td></tr>
118 <tr><td class="mdescLeft"> </td><td class="mdescRight">Add an item to a SEQUENCE node. <a href="#g16435917cd6c0261cd390fa8cf173b1b"></a><br></td></tr>
119 <tr><td class="memItemLeft" nowrap align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__nodes.html#g2db27002d8a9ae06b1729d0ee06553d2">yaml_document_append_mapping_pair</a> (<a class="el" href="structyaml__document__s.html">yaml_document_t</a> *document, int mapping, int key, int value)</td></tr>
121 <tr><td class="mdescLeft"> </td><td class="mdescRight">Add a pair of a key and a value to a MAPPING node. <a href="#g2db27002d8a9ae06b1729d0ee06553d2"></a><br></td></tr>
123 <hr><h2>Define Documentation</h2>
124 <a class="anchor" name="gdfa882b6e42a3a993d12392d55260b00"></a><!-- doxytag: member="yaml.h::YAML_NULL_TAG" ref="gdfa882b6e42a3a993d12392d55260b00" args="" -->
125 <div class="memitem">
126 <div class="memproto">
127 <table class="memname">
129 <td class="memname">#define YAML_NULL_TAG "tag:yaml.org,2002:null" </td>
136 The tag <code>!!null</code> with the only possible value: <code>null</code>.
141 <a class="anchor" name="g312629a1f51e91b136352db988d4d771"></a><!-- doxytag: member="yaml.h::YAML_BOOL_TAG" ref="g312629a1f51e91b136352db988d4d771" args="" -->
142 <div class="memitem">
143 <div class="memproto">
144 <table class="memname">
146 <td class="memname">#define YAML_BOOL_TAG "tag:yaml.org,2002:bool" </td>
153 The tag <code>!!bool</code> with the values: <code>true</code> and <code>falce</code>.
158 <a class="anchor" name="gc5dbc6d1f556663edf8db88d6113e931"></a><!-- doxytag: member="yaml.h::YAML_STR_TAG" ref="gc5dbc6d1f556663edf8db88d6113e931" args="" -->
159 <div class="memitem">
160 <div class="memproto">
161 <table class="memname">
163 <td class="memname">#define YAML_STR_TAG "tag:yaml.org,2002:str" </td>
170 The tag <code>!!str</code> for string values.
175 <a class="anchor" name="g83263cdb4ffa6ad2f7d9a87281979ff5"></a><!-- doxytag: member="yaml.h::YAML_INT_TAG" ref="g83263cdb4ffa6ad2f7d9a87281979ff5" args="" -->
176 <div class="memitem">
177 <div class="memproto">
178 <table class="memname">
180 <td class="memname">#define YAML_INT_TAG "tag:yaml.org,2002:int" </td>
187 The tag <code>!!int</code> for integer values.
192 <a class="anchor" name="g6ab2ec71fc47cb24f1003b9acdb92843"></a><!-- doxytag: member="yaml.h::YAML_FLOAT_TAG" ref="g6ab2ec71fc47cb24f1003b9acdb92843" args="" -->
193 <div class="memitem">
194 <div class="memproto">
195 <table class="memname">
197 <td class="memname">#define YAML_FLOAT_TAG "tag:yaml.org,2002:float" </td>
204 The tag <code>!!float</code> for float values.
209 <a class="anchor" name="g3e27cca7191234f2e8c95eaf3bc99a73"></a><!-- doxytag: member="yaml.h::YAML_TIMESTAMP_TAG" ref="g3e27cca7191234f2e8c95eaf3bc99a73" args="" -->
210 <div class="memitem">
211 <div class="memproto">
212 <table class="memname">
214 <td class="memname">#define YAML_TIMESTAMP_TAG "tag:yaml.org,2002:timestamp" </td>
221 The tag <code>!!timestamp</code> for date and time values.
226 <a class="anchor" name="ga8284b30f9c9e3f10f6a69c9b882f417"></a><!-- doxytag: member="yaml.h::YAML_SEQ_TAG" ref="ga8284b30f9c9e3f10f6a69c9b882f417" args="" -->
227 <div class="memitem">
228 <div class="memproto">
229 <table class="memname">
231 <td class="memname">#define YAML_SEQ_TAG "tag:yaml.org,2002:seq" </td>
238 The tag <code>!!seq</code> is used to denote sequences.
243 <a class="anchor" name="g22ae99cf3ac014dd76873268fd068c12"></a><!-- doxytag: member="yaml.h::YAML_MAP_TAG" ref="g22ae99cf3ac014dd76873268fd068c12" args="" -->
244 <div class="memitem">
245 <div class="memproto">
246 <table class="memname">
248 <td class="memname">#define YAML_MAP_TAG "tag:yaml.org,2002:map" </td>
255 The tag <code>!!map</code> is used to denote mapping.
260 <a class="anchor" name="gf6b0c4e819b8f6915515a4f70065aaaa"></a><!-- doxytag: member="yaml.h::YAML_DEFAULT_SCALAR_TAG" ref="gf6b0c4e819b8f6915515a4f70065aaaa" args="" -->
261 <div class="memitem">
262 <div class="memproto">
263 <table class="memname">
265 <td class="memname">#define YAML_DEFAULT_SCALAR_TAG YAML_STR_TAG </td>
272 The default scalar tag is <code>!!str</code>.
277 <a class="anchor" name="gf195b67002518702e27746d6b4da6124"></a><!-- doxytag: member="yaml.h::YAML_DEFAULT_SEQUENCE_TAG" ref="gf195b67002518702e27746d6b4da6124" args="" -->
278 <div class="memitem">
279 <div class="memproto">
280 <table class="memname">
282 <td class="memname">#define YAML_DEFAULT_SEQUENCE_TAG YAML_SEQ_TAG </td>
289 The default sequence tag is <code>!!seq</code>.
294 <a class="anchor" name="gf7b1f8f0ce5665794510cd3841802a5f"></a><!-- doxytag: member="yaml.h::YAML_DEFAULT_MAPPING_TAG" ref="gf7b1f8f0ce5665794510cd3841802a5f" args="" -->
295 <div class="memitem">
296 <div class="memproto">
297 <table class="memname">
299 <td class="memname">#define YAML_DEFAULT_MAPPING_TAG YAML_MAP_TAG </td>
306 The default mapping tag is <code>!!map</code>.
311 <hr><h2>Typedef Documentation</h2>
312 <a class="anchor" name="gbe020d2fc42d3e896549e9f97da622d2"></a><!-- doxytag: member="yaml.h::yaml_node_type_t" ref="gbe020d2fc42d3e896549e9f97da622d2" args="" -->
313 <div class="memitem">
314 <div class="memproto">
315 <table class="memname">
317 <td class="memname">typedef enum <a class="el" href="group__nodes.html#g0897d4b6bdd1b56c7a5fa0ff17b4f798">yaml_node_type_e</a> <a class="el" href="group__nodes.html#gbe020d2fc42d3e896549e9f97da622d2">yaml_node_type_t</a> </td>
329 <a class="anchor" name="g9eaaa233b120b9d9db47de93c294c40f"></a><!-- doxytag: member="yaml.h::yaml_node_t" ref="g9eaaa233b120b9d9db47de93c294c40f" args="" -->
330 <div class="memitem">
331 <div class="memproto">
332 <table class="memname">
334 <td class="memname">typedef struct <a class="el" href="structyaml__node__s.html">yaml_node_s</a> <a class="el" href="structyaml__node__s.html">yaml_node_t</a> </td>
341 The forward definition of a document node structure.
346 <a class="anchor" name="g7cc3581582e778b00c04e99cd3656860"></a><!-- doxytag: member="yaml.h::yaml_node_item_t" ref="g7cc3581582e778b00c04e99cd3656860" args="" -->
347 <div class="memitem">
348 <div class="memproto">
349 <table class="memname">
351 <td class="memname">typedef int <a class="el" href="group__nodes.html#g7cc3581582e778b00c04e99cd3656860">yaml_node_item_t</a> </td>
358 An element of a sequence node.
363 <a class="anchor" name="g90f1c8b83c5c38dc4016afc1cc2050c4"></a><!-- doxytag: member="yaml.h::yaml_node_pair_t" ref="g90f1c8b83c5c38dc4016afc1cc2050c4" args="" -->
364 <div class="memitem">
365 <div class="memproto">
366 <table class="memname">
368 <td class="memname">typedef struct <a class="el" href="structyaml__node__pair__s.html">yaml_node_pair_s</a> <a class="el" href="structyaml__node__pair__s.html">yaml_node_pair_t</a> </td>
375 An element of a mapping node.
380 <a class="anchor" name="gd94e064e95baeb22e4f7acc7804e8479"></a><!-- doxytag: member="yaml.h::yaml_document_t" ref="gd94e064e95baeb22e4f7acc7804e8479" args="" -->
381 <div class="memitem">
382 <div class="memproto">
383 <table class="memname">
385 <td class="memname">typedef struct <a class="el" href="structyaml__document__s.html">yaml_document_s</a> <a class="el" href="structyaml__document__s.html">yaml_document_t</a> </td>
392 The document structure.
397 <hr><h2>Enumeration Type Documentation</h2>
398 <a class="anchor" name="g0897d4b6bdd1b56c7a5fa0ff17b4f798"></a><!-- doxytag: member="yaml.h::yaml_node_type_e" ref="g0897d4b6bdd1b56c7a5fa0ff17b4f798" args="" -->
399 <div class="memitem">
400 <div class="memproto">
401 <table class="memname">
403 <td class="memname">enum <a class="el" href="group__nodes.html#g0897d4b6bdd1b56c7a5fa0ff17b4f798">yaml_node_type_e</a> </td>
412 <dl compact><dt><b>Enumerator: </b></dt><dd>
413 <table border="0" cellspacing="2" cellpadding="0">
414 <tr><td valign="top"><em><a class="anchor" name="gg0897d4b6bdd1b56c7a5fa0ff17b4f7980fa87c0e89c4d4136cb47165e6917739"></a><!-- doxytag: member="YAML_NO_NODE" ref="gg0897d4b6bdd1b56c7a5fa0ff17b4f7980fa87c0e89c4d4136cb47165e6917739" args="" -->YAML_NO_NODE</em> </td><td>
418 <tr><td valign="top"><em><a class="anchor" name="gg0897d4b6bdd1b56c7a5fa0ff17b4f798413ec8ce6b728c9ace703d194b370a45"></a><!-- doxytag: member="YAML_SCALAR_NODE" ref="gg0897d4b6bdd1b56c7a5fa0ff17b4f798413ec8ce6b728c9ace703d194b370a45" args="" -->YAML_SCALAR_NODE</em> </td><td>
422 <tr><td valign="top"><em><a class="anchor" name="gg0897d4b6bdd1b56c7a5fa0ff17b4f7986c03b52f7ee737982eac5e4001faac15"></a><!-- doxytag: member="YAML_SEQUENCE_NODE" ref="gg0897d4b6bdd1b56c7a5fa0ff17b4f7986c03b52f7ee737982eac5e4001faac15" args="" -->YAML_SEQUENCE_NODE</em> </td><td>
426 <tr><td valign="top"><em><a class="anchor" name="gg0897d4b6bdd1b56c7a5fa0ff17b4f798c1a08580e3a70973583fc85e3e097ee6"></a><!-- doxytag: member="YAML_MAPPING_NODE" ref="gg0897d4b6bdd1b56c7a5fa0ff17b4f798c1a08580e3a70973583fc85e3e097ee6" args="" -->YAML_MAPPING_NODE</em> </td><td>
435 <hr><h2>Function Documentation</h2>
436 <a class="anchor" name="g62a485c96f3b7962436a0da5e6f3cc89"></a><!-- doxytag: member="yaml.h::yaml_document_initialize" ref="g62a485c96f3b7962436a0da5e6f3cc89" args="(yaml_document_t *document, yaml_version_directive_t *version_directive, yaml_tag_directive_t *tag_directives_start, yaml_tag_directive_t *tag_directives_end, int start_implicit, int end_implicit)" -->
437 <div class="memitem">
438 <div class="memproto">
439 <table class="memname">
441 <td class="memname">int yaml_document_initialize </td>
443 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
444 <td class="paramname"> <em>document</em>, </td>
447 <td class="paramkey"></td>
449 <td class="paramtype"><a class="el" href="structyaml__version__directive__s.html">yaml_version_directive_t</a> * </td>
450 <td class="paramname"> <em>version_directive</em>, </td>
453 <td class="paramkey"></td>
455 <td class="paramtype"><a class="el" href="structyaml__tag__directive__s.html">yaml_tag_directive_t</a> * </td>
456 <td class="paramname"> <em>tag_directives_start</em>, </td>
459 <td class="paramkey"></td>
461 <td class="paramtype"><a class="el" href="structyaml__tag__directive__s.html">yaml_tag_directive_t</a> * </td>
462 <td class="paramname"> <em>tag_directives_end</em>, </td>
465 <td class="paramkey"></td>
467 <td class="paramtype">int </td>
468 <td class="paramname"> <em>start_implicit</em>, </td>
471 <td class="paramkey"></td>
473 <td class="paramtype">int </td>
474 <td class="paramname"> <em>end_implicit</em></td><td> </td>
479 <td></td><td></td><td></td>
486 Create a YAML document.
488 <dl compact><dt><b>Parameters:</b></dt><dd>
489 <table border="0" cellspacing="2" cellpadding="0">
490 <tr><td valign="top"><tt>[out]</tt> </td><td valign="top"><em>document</em> </td><td>An empty document object. </td></tr>
491 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>version_directive</em> </td><td>The YAML directive value or <code>NULL</code>. </td></tr>
492 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>tag_directives_start</em> </td><td>The beginning of the TAG directives list. </td></tr>
493 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>tag_directives_end</em> </td><td>The end of the TAG directives list. </td></tr>
494 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>start_implicit</em> </td><td>If the document start indicator is implicit. </td></tr>
495 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>end_implicit</em> </td><td>If the document end indicator is implicit.</td></tr>
498 <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl>
502 <a class="anchor" name="g2754b1544fb4e110e83fafbc708b0672"></a><!-- doxytag: member="yaml.h::yaml_document_delete" ref="g2754b1544fb4e110e83fafbc708b0672" args="(yaml_document_t *document)" -->
503 <div class="memitem">
504 <div class="memproto">
505 <table class="memname">
507 <td class="memname">void yaml_document_delete </td>
509 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
510 <td class="paramname"> <em>document</em> </td>
511 <td> ) </td>
519 Delete a YAML document and all its nodes.
521 <dl compact><dt><b>Parameters:</b></dt><dd>
522 <table border="0" cellspacing="2" cellpadding="0">
523 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
529 <a class="anchor" name="gfa1feabc9747dbded4dca24e27d3c21a"></a><!-- doxytag: member="yaml.h::yaml_document_get_node" ref="gfa1feabc9747dbded4dca24e27d3c21a" args="(yaml_document_t *document, int index)" -->
530 <div class="memitem">
531 <div class="memproto">
532 <table class="memname">
534 <td class="memname"><a class="el" href="structyaml__node__s.html">yaml_node_t</a>* yaml_document_get_node </td>
536 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
537 <td class="paramname"> <em>document</em>, </td>
540 <td class="paramkey"></td>
542 <td class="paramtype">int </td>
543 <td class="paramname"> <em>index</em></td><td> </td>
548 <td></td><td></td><td></td>
555 Get a node of a YAML document.
557 The pointer returned by this function is valid until any of the functions modifying the documents are called.<p>
558 <dl compact><dt><b>Parameters:</b></dt><dd>
559 <table border="0" cellspacing="2" cellpadding="0">
560 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
561 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>index</em> </td><td>The node id.</td></tr>
564 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the node objct or <code>NULL</code> if <code>node_id</code> is out of range. </dd></dl>
568 <a class="anchor" name="g40eeaa68fb2f3be34c4fe34e7597d324"></a><!-- doxytag: member="yaml.h::yaml_document_get_root_node" ref="g40eeaa68fb2f3be34c4fe34e7597d324" args="(yaml_document_t *document)" -->
569 <div class="memitem">
570 <div class="memproto">
571 <table class="memname">
573 <td class="memname"><a class="el" href="structyaml__node__s.html">yaml_node_t</a>* yaml_document_get_root_node </td>
575 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
576 <td class="paramname"> <em>document</em> </td>
577 <td> ) </td>
585 Get the root of a YAML document node.
587 The root object is the first object added to the document.<p>
588 The pointer returned by this function is valid until any of the functions modifying the documents are called.<p>
589 An empty document produced by the parser signifies the end of a YAML stream.<p>
590 <dl compact><dt><b>Parameters:</b></dt><dd>
591 <table border="0" cellspacing="2" cellpadding="0">
592 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>document</em> </td><td>A document object.</td></tr>
595 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the node object or <code>NULL</code> if the document is empty. </dd></dl>
599 <a class="anchor" name="g45dab8b983b58a005557d4b01f5057b0"></a><!-- doxytag: member="yaml.h::yaml_document_add_scalar" ref="g45dab8b983b58a005557d4b01f5057b0" args="(yaml_document_t *document, yaml_char_t *tag, yaml_char_t *value, int length, yaml_scalar_style_t style)" -->
600 <div class="memitem">
601 <div class="memproto">
602 <table class="memname">
604 <td class="memname">int yaml_document_add_scalar </td>
606 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
607 <td class="paramname"> <em>document</em>, </td>
610 <td class="paramkey"></td>
612 <td class="paramtype"><a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> * </td>
613 <td class="paramname"> <em>tag</em>, </td>
616 <td class="paramkey"></td>
618 <td class="paramtype"><a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> * </td>
619 <td class="paramname"> <em>value</em>, </td>
622 <td class="paramkey"></td>
624 <td class="paramtype">int </td>
625 <td class="paramname"> <em>length</em>, </td>
628 <td class="paramkey"></td>
630 <td class="paramtype"><a class="el" href="group__styles.html#g3fa6405631e1afe5bd5c488a6c5e8065">yaml_scalar_style_t</a> </td>
631 <td class="paramname"> <em>style</em></td><td> </td>
636 <td></td><td></td><td></td>
643 Create a SCALAR node and attach it to the document.
645 The <em>style</em> argument may be ignored by the emitter.<p>
646 <dl compact><dt><b>Parameters:</b></dt><dd>
647 <table border="0" cellspacing="2" cellpadding="0">
648 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
649 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>tag</em> </td><td>The scalar tag. </td></tr>
650 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>value</em> </td><td>The scalar value. </td></tr>
651 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>length</em> </td><td>The length of the scalar value. </td></tr>
652 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>style</em> </td><td>The scalar style.</td></tr>
655 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the node id or <code>0</code> on error. </dd></dl>
659 <a class="anchor" name="g83b2f7fdd9a439397a42016bddad7786"></a><!-- doxytag: member="yaml.h::yaml_document_add_sequence" ref="g83b2f7fdd9a439397a42016bddad7786" args="(yaml_document_t *document, yaml_char_t *tag, yaml_sequence_style_t style)" -->
660 <div class="memitem">
661 <div class="memproto">
662 <table class="memname">
664 <td class="memname">int yaml_document_add_sequence </td>
666 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
667 <td class="paramname"> <em>document</em>, </td>
670 <td class="paramkey"></td>
672 <td class="paramtype"><a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> * </td>
673 <td class="paramname"> <em>tag</em>, </td>
676 <td class="paramkey"></td>
678 <td class="paramtype"><a class="el" href="group__styles.html#g58a1123d271e56c72de6abf852ac4dc2">yaml_sequence_style_t</a> </td>
679 <td class="paramname"> <em>style</em></td><td> </td>
684 <td></td><td></td><td></td>
691 Create a SEQUENCE node and attach it to the document.
693 The <em>style</em> argument may be ignored by the emitter.<p>
694 <dl compact><dt><b>Parameters:</b></dt><dd>
695 <table border="0" cellspacing="2" cellpadding="0">
696 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
697 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>tag</em> </td><td>The sequence tag. </td></tr>
698 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>style</em> </td><td>The sequence style.</td></tr>
701 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the node id or <code>0</code> on error. </dd></dl>
705 <a class="anchor" name="g45a9f8288704f99cd81dc5cb31329d34"></a><!-- doxytag: member="yaml.h::yaml_document_add_mapping" ref="g45a9f8288704f99cd81dc5cb31329d34" args="(yaml_document_t *document, yaml_char_t *tag, yaml_mapping_style_t style)" -->
706 <div class="memitem">
707 <div class="memproto">
708 <table class="memname">
710 <td class="memname">int yaml_document_add_mapping </td>
712 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
713 <td class="paramname"> <em>document</em>, </td>
716 <td class="paramkey"></td>
718 <td class="paramtype"><a class="el" href="group__basic.html#gf8657e81f0b8b05d1a081001fc6cb8bd">yaml_char_t</a> * </td>
719 <td class="paramname"> <em>tag</em>, </td>
722 <td class="paramkey"></td>
724 <td class="paramtype"><a class="el" href="group__styles.html#gb47523846a5c5960e07367a28ea9750a">yaml_mapping_style_t</a> </td>
725 <td class="paramname"> <em>style</em></td><td> </td>
730 <td></td><td></td><td></td>
737 Create a MAPPING node and attach it to the document.
739 The <em>style</em> argument may be ignored by the emitter.<p>
740 <dl compact><dt><b>Parameters:</b></dt><dd>
741 <table border="0" cellspacing="2" cellpadding="0">
742 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
743 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>tag</em> </td><td>The sequence tag. </td></tr>
744 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>style</em> </td><td>The sequence style.</td></tr>
747 <dl class="return" compact><dt><b>Returns:</b></dt><dd>the node id or <code>0</code> on error. </dd></dl>
751 <a class="anchor" name="g16435917cd6c0261cd390fa8cf173b1b"></a><!-- doxytag: member="yaml.h::yaml_document_append_sequence_item" ref="g16435917cd6c0261cd390fa8cf173b1b" args="(yaml_document_t *document, int sequence, int item)" -->
752 <div class="memitem">
753 <div class="memproto">
754 <table class="memname">
756 <td class="memname">int yaml_document_append_sequence_item </td>
758 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
759 <td class="paramname"> <em>document</em>, </td>
762 <td class="paramkey"></td>
764 <td class="paramtype">int </td>
765 <td class="paramname"> <em>sequence</em>, </td>
768 <td class="paramkey"></td>
770 <td class="paramtype">int </td>
771 <td class="paramname"> <em>item</em></td><td> </td>
776 <td></td><td></td><td></td>
783 Add an item to a SEQUENCE node.
785 <dl compact><dt><b>Parameters:</b></dt><dd>
786 <table border="0" cellspacing="2" cellpadding="0">
787 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
788 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>sequence</em> </td><td>The sequence node id. </td></tr>
789 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>item</em> </td><td>The item node id.</td></tr>
792 <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl>
796 <a class="anchor" name="g2db27002d8a9ae06b1729d0ee06553d2"></a><!-- doxytag: member="yaml.h::yaml_document_append_mapping_pair" ref="g2db27002d8a9ae06b1729d0ee06553d2" args="(yaml_document_t *document, int mapping, int key, int value)" -->
797 <div class="memitem">
798 <div class="memproto">
799 <table class="memname">
801 <td class="memname">int yaml_document_append_mapping_pair </td>
803 <td class="paramtype"><a class="el" href="structyaml__document__s.html">yaml_document_t</a> * </td>
804 <td class="paramname"> <em>document</em>, </td>
807 <td class="paramkey"></td>
809 <td class="paramtype">int </td>
810 <td class="paramname"> <em>mapping</em>, </td>
813 <td class="paramkey"></td>
815 <td class="paramtype">int </td>
816 <td class="paramname"> <em>key</em>, </td>
819 <td class="paramkey"></td>
821 <td class="paramtype">int </td>
822 <td class="paramname"> <em>value</em></td><td> </td>
827 <td></td><td></td><td></td>
834 Add a pair of a key and a value to a MAPPING node.
836 <dl compact><dt><b>Parameters:</b></dt><dd>
837 <table border="0" cellspacing="2" cellpadding="0">
838 <tr><td valign="top"><tt>[in,out]</tt> </td><td valign="top"><em>document</em> </td><td>A document object. </td></tr>
839 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>mapping</em> </td><td>The mapping node id. </td></tr>
840 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>key</em> </td><td>The key node id. </td></tr>
841 <tr><td valign="top"><tt>[in]</tt> </td><td valign="top"><em>value</em> </td><td>The value node id.</td></tr>
844 <dl class="return" compact><dt><b>Returns:</b></dt><dd><code>1</code> if the function succeeded, <code>0</code> on error. </dd></dl>
849 <hr size="1"><address style="text-align: right;"><small>Generated on Sun Aug 30 22:52:14 2009 for yaml by
850 <a href="http://www.doxygen.org/index.html">
851 <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>