vf_parse_init(3) [debian man page]

vf_parse_init(3)					     Library Functions Manual						  vf_parse_init(3)

NAME

       vf_parse_init - vf_parse_init()

SYNOPSIS

       #include <../vformat/vf_iface.h>

       extern bool_t vf_parse_init
       (
	    VF_PARSER_T **pp_parser,
	    VF_OBJECT_T **pp_object
       );

PARAMETERS

       VF_PARSER_T **pp_parser
	      Ptr to allocated parser.

       VF_OBJECT_T **pp_object
	      The object we're parsing into.

DESCRIPTION

       Allocate  and  initialise  a  parser.   To  parse  a  VCARD  (or  any  vObject)	a  user  allocates  a parser, pushes data through it using
       vf_parse_text() and finally calls vf_parse_end():

       VF_PARSER_T *p_parser;

       if (vf_parse_init(&p_parser, pp_object)) { do { char buffer[...]; Int numchars;

       numchars = get_chars_from_somewhere(buffer, ...);

       Ret = vf_parse_text(p_parser, buffer, numchars); } while (ret && (0 < charsread)) ;

       if (!vf_parse_end(p_parser)) { ret = FALSE; } }

       A parser allocated by vf_parse_init(), must be deallocated by calling vf_parse_end() whether or not parsing succeeds. Also, parsing may not
       be  complete (ie. Values may be held buffered and not evaluated fully or assigned to a VF_OBJECT_T) untill the final call to vf_parse_end()
       => after a vf_parse_init() you _must_ vf_parse_end().

RETURNS

       TRUE iff parser allocated successfully.

SEE ALSO

       vf_parse_text(3), vf_parse_end(3), vf_read_file(3), vf_write_file(3),  vf_get_next_object(3),  vf_create_object(3),  vf_get_object_type(3),
       vf_get_property(3),	  vf_get_property_ex(3),	vf_get_next_property(3),	vf_get_prop_value(3),	     vf_set_prop_value(3),
       vf_get_prop_value_string(3),  vf_get_prop_name_string(3),  vf_set_prop_name_string(3),  vf_get_prop_name(3),   vf_get_prop_value_object(3),
       vf_set_prop_value_object(3),    vf_set_prop_value_string(3),    vf_set_prop_value_base64(3),    vf_get_prop_value_base64(3),   vf_set_prop-
       erty_from_file(3),   vf_delete_object(3),    vf_delete_prop(3),	  vf_find_prop_qual_index(3),	 vf_is_modified(3),    vf_find_charset(3),
       vf_date_string_to_time(3), vf_period_string_to_time(3), vf_period_time_to_string(3), vf_set_prop_value_time(3), vf_get_prop_value_time(3)

c2man vf_iface.h						   30 April 2003						  vf_parse_init(3)

XML_SET_ELEMENT_HANDLER(3)						 1						XML_SET_ELEMENT_HANDLER(3)

xml_set_element_handler - Set up start and end element handlers

SYNOPSIS

       bool xml_set_element_handler (resource  $parser, callable  $start_element_handler, callable  $end_element_handler)

DESCRIPTION

	Sets  the  element handler functions for the XML $parser. $start_element_handler and $end_element_handler are strings containing the names
       of functions that must exist when xml_parse(3) is called for $parser.

PARAMETERS

	      o $parser
		- A reference to the XML parser to set up start and end element handler functions.

	      o $start_element_handler
		- The function named by $start_element_handler must accept three parameters:
		 start_element_handler (resource  $parser, string  $name, array  $attribs)

		     o $parser
		       - The first parameter, parser, is a reference to the XML parser calling the handler.

		     o $name
		       - The second parameter, $name, contains the name of the element for which this handler  is  called.If  case-folding  is	in
		       effect for this parser, the element name will be in uppercase letters.

		     o $attribs
		       -  The  third  parameter,  $attribs,  contains an associative array with the element's attributes (if any).The keys of this
		       array are the attribute names, the values are the attribute values.Attribute names are case-folded on the same criteria	as
		       element	names.Attribute  values  are  not  case-folded.   The original order of the attributes can be retrieved by walking
		       through $attribs the normal way, using each(3).The first key in the array was the first attribute, and so on.

	      Note

		     Instead of a function name, an array containing an object reference and a method name can also be supplied.

	      o $end_element_handler
		- The function named by $end_element_handler must accept two parameters:
		 end_element_handler (resource	$parser, string  $name)

		     o $parser
		       - The first parameter, parser, is a reference to the XML parser calling the handler.

		     o $name
		       - The second parameter, $name, contains the name of the element for which this handler  is  called.If  case-folding  is	in
		       effect for this parser, the element name will be in uppercase letters.

	       If a handler function is set to an empty string, or FALSE, the handler in question is disabled.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

PHP Documentation Group 												XML_SET_ELEMENT_HANDLER(3)