1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
|
# XML Parser
We have a rudimentary XML parser that handles well formed XML. It does not do
any namespace processing, and it does not validate the XML syntax.
The parser supports `UTF-8`, `UTF-16`, `iso-8859-1`, `iso-8859-7`, `koi8`,
`windows-1250`, `windows-1251`, and `windows-1252` encoded input.
If `preserve_white` is *false*, we will discard all *whitespace-only* text
elements. This is useful for parsing non-text documents such as XPS and SVG.
Preserving whitespace is useful for parsing XHTML.
typedef struct { opaque } fz_xml_doc;
typedef struct { opaque } fz_xml;
fz_xml_doc *fz_parse_xml(fz_context *ctx, fz_buffer *buf, int preserve_white);
void fz_drop_xml(fz_context *ctx, fz_xml_doc *xml);
fz_xml *fz_xml_root(fz_xml_doc *xml);
fz_xml *fz_xml_prev(fz_xml *item);
fz_xml *fz_xml_next(fz_xml *item);
fz_xml *fz_xml_up(fz_xml *item);
fz_xml *fz_xml_down(fz_xml *item);
`int fz_xml_is_tag(fz_xml *item, const char *name);`
: Returns *true* if the element is a tag with the given name.
`char *fz_xml_tag(fz_xml *item);`
: Returns the tag name if the element is a tag, otherwise `NULL`.
`char *fz_xml_att(fz_xml *item, const char *att);`
: Returns the value of the tag element's attribute, or `NULL` if not a tag or missing.
`char *fz_xml_text(fz_xml *item);`
: Returns the `UTF-8` text of the text element, or `NULL` if not a text element.
`fz_xml *fz_xml_find(fz_xml *item, const char *tag);`
: Find the next element with the given tag name. Returns the element
itself if it matches, or the first sibling if it doesn't. Returns
`NULL` if there is no sibling with that tag name.
`fz_xml *fz_xml_find_next(fz_xml *item, const char *tag);`
: Find the next sibling element with the given tag name, or `NULL` if none.
`fz_xml *fz_xml_find_down(fz_xml *item, const char *tag);`
: Find the first child element with the given tag name, or `NULL` if none.
|
