~ubuntu-branches/ubuntu/hardy/glib2.0/hardy-updates

« back to all changes in this revision

Viewing changes to docs/reference/glib/html/glib-Simple-XML-Subset-Parser.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge, Sjoerd Simons, Sebastian Dröge
  • Date: 2008-04-08 12:02:07 UTC
  • mfrom: (1.2.40 upstream)
  • Revision ID: james.westby@ubuntu.com-20080408120207-8a2nownsi3sccoxs
Tags: 2.16.3-1
[ Sjoerd Simons ]
* debian/patches/70_g_timeout_seconds_fix.patch
  + Added. Fix a rare case where a timeout from g_timeout_add_seconds() is
  never triggered. See http://bugzilla.gnome.org/show_bug.cgi?id=448943

[ Sebastian Dröge ]
* New upstream bugfix release:
  + debian/patches/70_g_timeout_seconds_fix.patch:
    - Dropped, merged upstream.

Show diffs side-by-side

added added

removed removed

Lines of Context:
36
36
<th width="100%" align="center">GLib Reference Manual</th>
37
37
<td><a accesskey="n" href="glib-Key-value-file-parser.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
38
38
</tr>
39
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3312963" class="shortcut">Top</a>
 
39
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id3221111" class="shortcut">Top</a>
40
40
                  &#160;|&#160;
41
 
                  <a href="#id3313418" class="shortcut">Description</a></nobr></td></tr>
 
41
                  <a href="#id3221566" class="shortcut">Description</a></nobr></td></tr>
42
42
</table>
43
43
<div class="refentry" lang="en">
44
44
<a name="glib-Simple-XML-Subset-Parser"></a><div class="titlepage"></div>
45
45
<div class="refnamediv"><table width="100%"><tr>
46
46
<td valign="top">
47
47
<h2>
48
 
<a name="id3312963"></a><span class="refentrytitle">Simple XML Subset Parser</span>
 
48
<a name="id3221111"></a><span class="refentrytitle">Simple XML Subset Parser</span>
49
49
</h2>
50
50
<p>Simple XML Subset Parser &#8212; parses a subset of XML</p>
51
51
</td>
99
99
</pre>
100
100
</div>
101
101
<div class="refsect1" lang="en">
102
 
<a name="id3313418"></a><h2>Description</h2>
 
102
<a name="id3221566"></a><h2>Description</h2>
103
103
<p>
104
104
The "GMarkup" parser is intended to parse a simple markup format
105
105
that's a subset of XML. This is a small, efficient, easy-to-use
160
160
</p>
161
161
</div>
162
162
<div class="refsect1" lang="en">
163
 
<a name="id3313548"></a><h2>Details</h2>
 
163
<a name="id3221696"></a><h2>Details</h2>
164
164
<div class="refsect2" lang="en">
165
 
<a name="id3313558"></a><h3>
 
165
<a name="id3221706"></a><h3>
166
166
<a name="GMarkupError"></a>enum GMarkupError</h3>
167
 
<a class="indexterm" name="id3313571"></a><pre class="programlisting">typedef enum
 
167
<a class="indexterm" name="id3221719"></a><pre class="programlisting">typedef enum
168
168
{
169
169
  G_MARKUP_ERROR_BAD_UTF8,
170
170
  G_MARKUP_ERROR_EMPTY,
225
225
</div>
226
226
<hr>
227
227
<div class="refsect2" lang="en">
228
 
<a name="id3313796"></a><h3>
 
228
<a name="id3221944"></a><h3>
229
229
<a name="G-MARKUP-ERROR:CAPS"></a>G_MARKUP_ERROR</h3>
230
 
<a class="indexterm" name="id3313808"></a><pre class="programlisting">#define G_MARKUP_ERROR g_markup_error_quark ()
 
230
<a class="indexterm" name="id3221956"></a><pre class="programlisting">#define G_MARKUP_ERROR g_markup_error_quark ()
231
231
</pre>
232
232
<p>
233
233
Error domain for markup parsing. Errors in this domain will
237
237
</div>
238
238
<hr>
239
239
<div class="refsect2" lang="en">
240
 
<a name="id3313842"></a><h3>
 
240
<a name="id3221990"></a><h3>
241
241
<a name="GMarkupParseFlags"></a>enum GMarkupParseFlags</h3>
242
 
<a class="indexterm" name="id3313855"></a><pre class="programlisting">typedef enum
 
242
<a class="indexterm" name="id3222003"></a><pre class="programlisting">typedef enum
243
243
{
244
244
  G_MARKUP_DO_NOT_USE_THIS_UNSUPPORTED_FLAG = 1 &lt;&lt; 0,
245
245
  G_MARKUP_TREAT_CDATA_AS_TEXT              = 1 &lt;&lt; 1,
281
281
</div>
282
282
<hr>
283
283
<div class="refsect2" lang="en">
284
 
<a name="id3313991"></a><h3>
 
284
<a name="id3222139"></a><h3>
285
285
<a name="GMarkupParseContext"></a>GMarkupParseContext</h3>
286
 
<a class="indexterm" name="id3314004"></a><pre class="programlisting">typedef struct _GMarkupParseContext GMarkupParseContext;</pre>
 
286
<a class="indexterm" name="id3222152"></a><pre class="programlisting">typedef struct _GMarkupParseContext GMarkupParseContext;</pre>
287
287
<p>
288
288
A parse context is used to parse a stream of bytes that you expect to
289
289
contain marked-up text. See <a class="link" href="glib-Simple-XML-Subset-Parser.html#g-markup-parse-context-new"><code class="function">g_markup_parse_context_new()</code></a>,
292
292
</div>
293
293
<hr>
294
294
<div class="refsect2" lang="en">
295
 
<a name="id3314041"></a><h3>
 
295
<a name="id3222189"></a><h3>
296
296
<a name="GMarkupParser"></a>GMarkupParser</h3>
297
 
<a class="indexterm" name="id3314054"></a><pre class="programlisting">typedef struct {
 
297
<a class="indexterm" name="id3222202"></a><pre class="programlisting">typedef struct {
298
298
  /* Called for open tags &lt;foo bar="baz"&gt; */
299
299
  void (*start_element)  (GMarkupParseContext *context,
300
300
                          const gchar         *element_name,
390
390
</div>
391
391
<hr>
392
392
<div class="refsect2" lang="en">
393
 
<a name="id3314339"></a><h3>
 
393
<a name="id3222487"></a><h3>
394
394
<a name="g-markup-escape-text"></a>g_markup_escape_text ()</h3>
395
 
<a class="indexterm" name="id3314352"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_escape_text                (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *text,
 
395
<a class="indexterm" name="id3222500"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_escape_text                (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *text,
396
396
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> length);</pre>
397
397
<p>
398
398
Escapes text so that the markup parser will parse it verbatim.
430
430
</div>
431
431
<hr>
432
432
<div class="refsect2" lang="en">
433
 
<a name="id3314452"></a><h3>
 
433
<a name="id3222600"></a><h3>
434
434
<a name="g-markup-printf-escaped"></a>g_markup_printf_escaped ()</h3>
435
 
<a class="indexterm" name="id3314467"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_printf_escaped             (const char *format,
 
435
<a class="indexterm" name="id3222615"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_printf_escaped             (const char *format,
436
436
                                                         ...);</pre>
437
437
<p>
438
438
Formats arguments according to <em class="parameter"><code>format</code></em>, escaping
485
485
</div>
486
486
<hr>
487
487
<div class="refsect2" lang="en">
488
 
<a name="id3314608"></a><h3>
 
488
<a name="id3222756"></a><h3>
489
489
<a name="g-markup-vprintf-escaped"></a>g_markup_vprintf_escaped ()</h3>
490
 
<a class="indexterm" name="id3314624"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_vprintf_escaped            (const char *format,
 
490
<a class="indexterm" name="id3222772"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*              g_markup_vprintf_escaped            (const char *format,
491
491
                                                         va_list args);</pre>
492
492
<p>
493
493
Formats the data in <em class="parameter"><code>args</code></em> according to <em class="parameter"><code>format</code></em>, escaping
523
523
</div>
524
524
<hr>
525
525
<div class="refsect2" lang="en">
526
 
<a name="id3314779"></a><h3>
 
526
<a name="id3222927"></a><h3>
527
527
<a name="g-markup-parse-context-end-parse"></a>g_markup_parse_context_end_parse ()</h3>
528
 
<a class="indexterm" name="id3314793"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_parse_context_end_parse    (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
 
528
<a class="indexterm" name="id3222941"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_parse_context_end_parse    (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
529
529
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
530
530
<p>
531
531
Signals to the <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a> that all data has been
558
558
</div>
559
559
<hr>
560
560
<div class="refsect2" lang="en">
561
 
<a name="id3314934"></a><h3>
 
561
<a name="id3223082"></a><h3>
562
562
<a name="g-markup-parse-context-free"></a>g_markup_parse_context_free ()</h3>
563
 
<a class="indexterm" name="id3314948"></a><pre class="programlisting">void                g_markup_parse_context_free         (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context);</pre>
 
563
<a class="indexterm" name="id3223096"></a><pre class="programlisting">void                g_markup_parse_context_free         (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context);</pre>
564
564
<p>
565
565
Frees a <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext"><span class="type">GMarkupParseContext</span></a>. Can't be called from inside
566
566
one of the <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParser"><span class="type">GMarkupParser</span></a> functions.</p>
578
578
</div>
579
579
<hr>
580
580
<div class="refsect2" lang="en">
581
 
<a name="id3315023"></a><h3>
 
581
<a name="id3223171"></a><h3>
582
582
<a name="g-markup-parse-context-get-position"></a>g_markup_parse_context_get_position ()</h3>
583
 
<a class="indexterm" name="id3315038"></a><pre class="programlisting">void                g_markup_parse_context_get_position (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
 
583
<a class="indexterm" name="id3223186"></a><pre class="programlisting">void                g_markup_parse_context_get_position (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
584
584
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> *line_number,
585
585
                                                         <a class="link" href="glib-Basic-Types.html#gint">gint</a> *char_number);</pre>
586
586
<p>
614
614
</div>
615
615
<hr>
616
616
<div class="refsect2" lang="en">
617
 
<a name="id3315164"></a><h3>
 
617
<a name="id3223312"></a><h3>
618
618
<a name="g-markup-parse-context-get-element"></a>g_markup_parse_context_get_element ()</h3>
619
 
<a class="indexterm" name="id3315181"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_markup_parse_context_get_element  (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context);</pre>
 
619
<a class="indexterm" name="id3223329"></a><pre class="programlisting">const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a>*        g_markup_parse_context_get_element  (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context);</pre>
620
620
<p>
621
621
Retrieves the name of the currently open element.
622
622
</p>
647
647
</div>
648
648
<hr>
649
649
<div class="refsect2" lang="en">
650
 
<a name="id3315286"></a><h3>
 
650
<a name="id3223434"></a><h3>
651
651
<a name="g-markup-parse-context-get-element-stack"></a>g_markup_parse_context_get_element_stack ()</h3>
652
 
<a class="indexterm" name="id3315300"></a><pre class="programlisting">const <a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*       g_markup_parse_context_get_element_stack
 
652
<a class="indexterm" name="id3223448"></a><pre class="programlisting">const <a class="link" href="glib-Singly-Linked-Lists.html#GSList">GSList</a>*       g_markup_parse_context_get_element_stack
653
653
                                                        (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context);</pre>
654
654
<p>
655
655
Retrieves the element stack from the internal state of the parser.
686
686
</div>
687
687
<hr>
688
688
<div class="refsect2" lang="en">
689
 
<a name="id3315413"></a><h3>
 
689
<a name="id3223561"></a><h3>
690
690
<a name="g-markup-parse-context-new"></a>g_markup_parse_context_new ()</h3>
691
 
<a class="indexterm" name="id3315426"></a><pre class="programlisting"><a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a>* g_markup_parse_context_new         (const <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParser">GMarkupParser</a> *parser,
 
691
<a class="indexterm" name="id3223574"></a><pre class="programlisting"><a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a>* g_markup_parse_context_new         (const <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParser">GMarkupParser</a> *parser,
692
692
                                                         <a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseFlags">GMarkupParseFlags</a> flags,
693
693
                                                         <a class="link" href="glib-Basic-Types.html#gpointer">gpointer</a> user_data,
694
694
                                                         <a class="link" href="glib-Datasets.html#GDestroyNotify">GDestroyNotify</a> user_data_dnotify);</pre>
734
734
</div>
735
735
<hr>
736
736
<div class="refsect2" lang="en">
737
 
<a name="id3315592"></a><h3>
 
737
<a name="id3223740"></a><h3>
738
738
<a name="g-markup-parse-context-parse"></a>g_markup_parse_context_parse ()</h3>
739
 
<a class="indexterm" name="id3315605"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_parse_context_parse        (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
 
739
<a class="indexterm" name="id3223753"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_parse_context_parse        (<a class="link" href="glib-Simple-XML-Subset-Parser.html#GMarkupParseContext">GMarkupParseContext</a> *context,
740
740
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *text,
741
741
                                                         <a class="link" href="glib-Basic-Types.html#gssize">gssize</a> text_len,
742
742
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error);</pre>
785
785
</div>
786
786
<hr>
787
787
<div class="refsect2" lang="en">
788
 
<a name="id3315798"></a><h3>
 
788
<a name="id3223946"></a><h3>
789
789
<a name="GMarkupCollectType"></a>enum GMarkupCollectType</h3>
790
 
<a class="indexterm" name="id3315812"></a><pre class="programlisting">typedef enum
 
790
<a class="indexterm" name="id3223960"></a><pre class="programlisting">typedef enum
791
791
{
792
792
  G_MARKUP_COLLECT_INVALID,
793
793
  G_MARKUP_COLLECT_STRING,
871
871
</div>
872
872
<hr>
873
873
<div class="refsect2" lang="en">
874
 
<a name="id3316116"></a><h3>
 
874
<a name="id3224264"></a><h3>
875
875
<a name="g-markup-collect-attributes"></a>g_markup_collect_attributes ()</h3>
876
 
<a class="indexterm" name="id3316132"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_collect_attributes         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *element_name,
 
876
<a class="indexterm" name="id3224280"></a><pre class="programlisting"><a class="link" href="glib-Basic-Types.html#gboolean">gboolean</a>            g_markup_collect_attributes         (const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> *element_name,
877
877
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **attribute_names,
878
878
                                                         const <a class="link" href="glib-Basic-Types.html#gchar">gchar</a> **attribute_values,
879
879
                                                         <a class="link" href="glib-Error-Reporting.html#GError">GError</a> **error,
986
986
</div>
987
987
</div>
988
988
<div class="refsect1" lang="en">
989
 
<a name="id3316559"></a><div class="refsect2" lang="en"><a name="id3316560"></a></div>
 
989
<a name="id3224707"></a><div class="refsect2" lang="en"><a name="id3224708"></a></div>
990
990
<hr>
991
 
<div class="refsect2" lang="en"><a name="id3316561"></a></div>
 
991
<div class="refsect2" lang="en"><a name="id3224709"></a></div>
992
992
</div>
993
993
<div class="footnotes">
994
994
<br><hr width="100" align="left">