File: expat.hlp

package info (click to toggle)
slexpat 0.5.0-1
  • links: PTS, VCS
  • area: main
  • in suites: lenny
  • size: 112 kB
  • ctags: 120
  • sloc: ansic: 776; makefile: 37
file content (328 lines) | stat: -rw-r--r-- 7,723 bytes parent folder | download | duplicates (3)
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
xml_new

 SYNOPSIS
  Instantiate a new Expat_Type object

 USAGE
  Expat_Type xml_new()

 DESCRIPTION
  This function instantiates and returns an Expat_Type.  The
  Expat_Type is an opaque type, but its internals can be accessed
  with the dot operator like in a structure:

  `.userdata': see `xml_set_user_data'

  `.startelementhandler': see `xml_set_start_element_handler'

  `.endelementhandler': see `xml_set_end_element_handler'

  `.characterdatahandler': see `xml_set_character_data_handler'

  `.defaulthandler': see `xml_set_default_handler'

  The following properties do nothing unless the Expat parser was created
  with `xml_new_ns':

  `.startnamespacedeclhandler':  see `xml_set_start_namespace_decl_handler'

  `.endnamespacedeclhandler':  see `xml_set_end_namespace_decl_handler'

  The following properties are read-only and correspond to the C functions
  XML_GetErrorCode etc:

  `.errorcode': the error status of the parser.  This will be
  `ExpatError' or a subclass thereof, not expat's internal error
  code.

  `.errorstring': the description of the error status.

  `.currentbyteindex': the byte offset of the position.

  `.currentline':  the line number of the position. The first line is
  reported as 1.

  `.currentcolumn': the offset, from the beginning of the current line, of the
   position.

  `.parsingstatus': a struct {Int_Type parsing, Int_Type
  finalbuffer}.
   `.parsing.parsingstatus' can take on four values:

     XML_INITIALIZED
     XML_PARSING
     XML_FINISHED
     XML_SUSPENDED

   `.parsing.finalbuffer' is one if the final buffer is being processed -
   that is, when `xml_parse' was called with the third argument 1.

 SEE ALSO
  xml_parse, xml_new_ns

--------------------------------------------------------------

xml_new_ns

 SYNOPSIS
  Instantiate an Expat_Type object with namespace processing

 USAGE
  Expat_Type xml_new_ns(Char_Type sep)

 DESCRIPTION
  Constructs a new parser that has namespace processing in effect. Namespace
  expanded element names and attribute names are returned as a concatenation
  of the namespace URI, sep, and the local part of the name. This means that
  you should pick a character for sep that can't be part of a legal URI.

 SEE ALSO
  xml_parse, xml_new

--------------------------------------------------------------

xml_parse

 SYNOPSIS
  parse part of and xml document

 USAGE
  xml_parse(Expat_Type p, String_Type s, Int_Type isFinal)

 DESCRIPTION
  Parse some more of the document.  The string s is a buffer containing part
  (or perhaps all) of the document.  The isFinal parameter informs the parser
  that this is the last piece of the document.  Frequently, the last piece is
  empty (i.e. len is zero).  If a parse error occurred, an `ExpatError'
  is thrown.

 SEE ALSO
  xml_new, xml_stop_parser

--------------------------------------------------------------

xml_stop_parser

 SYNOPSIS
  stop parsing

 USAGE
  xml_stop_parser(Expat_Type p, Int_Type resumable)

 DESCRIPTION
  Stops parsing, causing `xml_parse' to return. Must be called from
  within a call-back handler, except when aborting (when resumable is 0) an
  already suspended parser.

 SEE ALSO
  xml_new, xml_resume_parser

--------------------------------------------------------------

xml_resume_parser

 SYNOPSIS
  resume parsing

 USAGE
  xml_resume_parser(Expat_Type p)

 DESCRIPTION
  Resumes parsing after it has been suspended with `xml_stop_parser'.
  Must not be called from within a handler call-back.

 SEE ALSO
  xml_new, xml_stop_parser

--------------------------------------------------------------

xml_set_start_element_handler

 SYNOPSIS
  set the start element handler

 USAGE
  xml_set_start_element_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Set the handler for start elements.  The handler should have the prototype

  handler(p, name, atttributes)
  Expat_Type p;
  String_Type name;
  Array_Type[Struct_Type{name, value}] atttributes;

  The handler can acces the parser's userdata with
  `xml_get_user_data(p)' or as p.userdata.

 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new, xml_parse

--------------------------------------------------------------

xml_set_end_element_handler

 SYNOPSIS
  set the end element handler

 USAGE
  xml_set_end_element_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Set the handler for end elements.  The handler should have the prototype

  handler(p, name)
  Expat_Type p;
  String_Type name;

  The handler can acces the parser's userdata with
  `xml_get_user_data(p)' or as p.userdata.

 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new, xml_parse

--------------------------------------------------------------

xml_set_start_namespace_decl_handler

 SYNOPSIS
  set the start namespace_decl handler

 USAGE
  xml_set_start_namespace_decl_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Set a handler to be called when a namespace is declared. Namespace
  declarations occur inside start tags. But the namespace declaration start
  handler is called before the start tag handler for each namespace declared
  in that start tag.  The handler should have the prototype

  handler(p, prefix, uri)
  Expat_Type p;
  String_Type  or NULL prefix;
  String_Type or NULL uri;


 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new_ns, xml_parse

--------------------------------------------------------------

xml_set_end_namespace_decl_handler

 SYNOPSIS
  set the end namespace_decl handler

 USAGE
  xml_set_end_namespace_decl_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Set a handler to be called when leaving the scope of a namespace
  declaration.  This will be called, for each namespace declaration, after
  the handler for the end tag of the element in which the namespace was
  declared.  The handler should have the prototype

  handler(p, prefix)
  Expat_Type p;
  String_Type or NULL prefix;


 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new_ns, xml_parse

--------------------------------------------------------------

xml_set_character_data_handler

 SYNOPSIS
  set the character data handler

 USAGE
  xml_set_character_data_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Set the handler for character data.  The handler should have the prototype

  handler(p, data)
  Expat_Type p;
  String_Type data;

  The handler can acces the parser's userdata with
  `xml_get_user_data(p)' or as p.userdata.

 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new, xml_parse

--------------------------------------------------------------

xml_set_default_handler

 SYNOPSIS
  set the character data handler

 USAGE
  xml_set_default_handler(Expat_Type p, Ref_Type handler)

 DESCRIPTION
  Sets a handler for any characters in the document which wouldn't otherwise
  be handled. The handler should have the prototype

  handler(p, data)
  Expat_Type p;
  String_Type data;


 NOTES
  To unset the handler, set it to NULL

 SEE ALSO
  xml_new, xml_parse

--------------------------------------------------------------

xml_set_user_data

 SYNOPSIS
  Set the user data associated with an XML parser

 USAGE
  xml_set_user_data(Expat_Type p, AnyType data)

 DESCRIPTION
  This sets the user data pointer that gets passed to handlers.

 SEE ALSO
  xml_new, xml_get_user_data

--------------------------------------------------------------

xml_get_user_data

 SYNOPSIS
  Get the user data associated with an XML parser

 USAGE
  AnyType xml_get_user_data(Expat_Type p)

 DESCRIPTION
  This gets the user data pointer that gets passed to handlers.

 SEE ALSO
  xml_new, xml_set_user_data

--------------------------------------------------------------