mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2025-10-03 12:19:20 +02:00
docs: Add simple GMarkup parser example
Based on an initial parser by Luc Pionchon. https://bugzilla.gnome.org/show_bug.cgi?id=442929
This commit is contained in:
@@ -81,6 +81,8 @@
|
||||
* <listitem>Character references</listitem>
|
||||
* <listitem>Sections marked as CDATA</listitem>
|
||||
* </itemizedlist>
|
||||
*
|
||||
* <example id="gmarkup-example"><title>Example GMarkup parser</title><programlisting><xi:include xmlns:xi="http://www.w3.org/2001/XInclude" parse="text" href="../../../../glib/tests/markup-example.c"><xi:fallback>FIXME: MISSING XINCLUDE CONTENT</xi:fallback></xi:include></programlisting></example>
|
||||
*/
|
||||
|
||||
G_DEFINE_QUARK (g-markup-error-quark, g_markup_error)
|
||||
|
1
glib/tests/.gitignore
vendored
1
glib/tests/.gitignore
vendored
@@ -36,6 +36,7 @@ mainloop
|
||||
mappedfile
|
||||
markup-collect
|
||||
markup-escape
|
||||
markup-example
|
||||
markup-parse
|
||||
markup-subparser
|
||||
mem-overflow
|
||||
|
@@ -62,6 +62,9 @@ markup_collect_LDADD = $(progs_ldadd)
|
||||
TEST_PROGS += markup-escape
|
||||
markup_escape_LDADD = $(progs_ldadd)
|
||||
|
||||
TEST_PROGS += markup-example
|
||||
markup_example_LDADD = $(progs_ldadd)
|
||||
|
||||
TEST_PROGS += markup-subparser
|
||||
markup_subparser_LDADD = $(progs_ldadd)
|
||||
|
||||
|
150
glib/tests/markup-example.c
Normal file
150
glib/tests/markup-example.c
Normal file
@@ -0,0 +1,150 @@
|
||||
#include <glib.h>
|
||||
|
||||
/*
|
||||
* Example XML for the parser.
|
||||
*/
|
||||
static const gchar foo_xml_example[] =
|
||||
"<foo bar='baz' bir='boz'>"
|
||||
" <bar>bar text 1</bar> "
|
||||
" <bar>bar text 2</bar> "
|
||||
" foo text "
|
||||
"<!-- nothing --> "
|
||||
"</foo> ";
|
||||
|
||||
static void foo_parser_start_element (GMarkupParseContext *context,
|
||||
const gchar *element_name,
|
||||
const gchar **attribute_names,
|
||||
const gchar **attribute_values,
|
||||
gpointer user_data,
|
||||
GError **error);
|
||||
static void foo_parser_end_element (GMarkupParseContext *context,
|
||||
const gchar *element_name,
|
||||
gpointer user_data,
|
||||
GError **error);
|
||||
static void foo_parser_characters (GMarkupParseContext *context,
|
||||
const gchar *text,
|
||||
gsize text_len,
|
||||
gpointer user_data,
|
||||
GError **error);
|
||||
static void foo_parser_passthrough (GMarkupParseContext *context,
|
||||
const gchar *passthrough_text,
|
||||
gsize text_len,
|
||||
gpointer user_data,
|
||||
GError **error);
|
||||
static void foo_parser_error (GMarkupParseContext *context,
|
||||
GError *error,
|
||||
gpointer user_data);
|
||||
|
||||
/*
|
||||
* Parser
|
||||
*/
|
||||
static const GMarkupParser foo_xml_parser = {
|
||||
foo_parser_start_element,
|
||||
foo_parser_end_element,
|
||||
foo_parser_characters,
|
||||
foo_parser_passthrough,
|
||||
foo_parser_error
|
||||
};
|
||||
|
||||
/*
|
||||
* Called for opening tags like <foo bar="baz">
|
||||
*/
|
||||
static void
|
||||
foo_parser_start_element (GMarkupParseContext *context,
|
||||
const gchar *element_name,
|
||||
const gchar **attribute_names,
|
||||
const gchar **attribute_values,
|
||||
gpointer user_data,
|
||||
GError **error)
|
||||
{
|
||||
gsize i;
|
||||
|
||||
g_print ("element: <%s>\n", element_name);
|
||||
|
||||
for (i = 0; attribute_names[i]; i++)
|
||||
{
|
||||
g_print ("attribute: %s = \"%s\"\n", attribute_names[i],
|
||||
attribute_values[i]);
|
||||
}
|
||||
}
|
||||
|
||||
/*
|
||||
* Called for closing tags like </foo>
|
||||
*/
|
||||
static void
|
||||
foo_parser_end_element (GMarkupParseContext *context,
|
||||
const gchar *element_name,
|
||||
gpointer user_data,
|
||||
GError **error)
|
||||
{
|
||||
g_print ("attribute: </%s>\n", element_name);
|
||||
}
|
||||
|
||||
/*
|
||||
* Called for character data. Text is not nul-terminated
|
||||
*/
|
||||
static void
|
||||
foo_parser_characters (GMarkupParseContext *context,
|
||||
const gchar *text,
|
||||
gsize text_len,
|
||||
gpointer user_data,
|
||||
GError **error)
|
||||
{
|
||||
g_print ("text: [%s]\n", text);
|
||||
}
|
||||
|
||||
/*
|
||||
* Called for strings that should be re-saved verbatim in this same
|
||||
* position, but are not otherwise interpretable. At the moment this
|
||||
* includes comments and processing instructions. Text is not
|
||||
* nul-terminated.
|
||||
*/
|
||||
static void
|
||||
foo_parser_passthrough (GMarkupParseContext *context,
|
||||
const gchar *passthrough_text,
|
||||
gsize text_len,
|
||||
gpointer user_data,
|
||||
GError **error)
|
||||
{
|
||||
g_print ("passthrough: %s\n", passthrough_text);
|
||||
}
|
||||
|
||||
/*
|
||||
* Called when any parsing method encounters an error. The GError should not be
|
||||
* freed.
|
||||
*/
|
||||
static void
|
||||
foo_parser_error (GMarkupParseContext *context,
|
||||
GError *error,
|
||||
gpointer user_data)
|
||||
{
|
||||
g_printerr ("ERROR: %s\n", error->message);
|
||||
}
|
||||
|
||||
int main ()
|
||||
{
|
||||
GMarkupParseContext *context;
|
||||
gboolean success = FALSE;
|
||||
glong len;
|
||||
|
||||
len = g_utf8_strlen (foo_xml_example, -1);
|
||||
g_print ("Parsing: %s\n", foo_xml_example);
|
||||
g_print ("(%ld UTF8 characters)\n", len);
|
||||
|
||||
context = g_markup_parse_context_new (&foo_xml_parser, 0, NULL, NULL);
|
||||
|
||||
success = g_markup_parse_context_parse (context, foo_xml_example, len, NULL);
|
||||
|
||||
g_markup_parse_context_free (context);
|
||||
|
||||
if (success)
|
||||
{
|
||||
g_print ("DONE\n");
|
||||
return 0;
|
||||
}
|
||||
else
|
||||
{
|
||||
g_printerr ("ERROR\n");
|
||||
return 1;
|
||||
}
|
||||
}
|
Reference in New Issue
Block a user