Class: XML_Parser_Simple

Source Location: /XML_Parser-1.2.0beta2/Parser/Simple.php

Class Overview

PEAR
   |
   --XML_Parser
      |
      --XML_Parser_Simple

Simple XML parser class.

Author(s):

Stephan Schmidt <schst at php-tools.net>

Methods

Child classes:

: Simple XML parser class.

myParser2: Simple XML parser class.

Inherited Variables

Class: XML_Parser

XML_Parser::$folding
XML_Parser::$fp
XML_Parser::$handler
XML_Parser::$mode
XML_Parser::$parser
XML_Parser::$srcenc
XML_Parser::$tgtenc

Inherited Methods

Class: XML_Parser

XML_Parser::__construct(): PHP5 constructor
XML_Parser::XML_Parser(): Creates an XML parser.
XML_Parser::endHandler()
XML_Parser::free(): XML_Parser::free()
XML_Parser::funcEndHandler()
XML_Parser::funcStartHandler()
XML_Parser::parse(): Central parsing function.
XML_Parser::parseString(): XML_Parser::parseString()
XML_Parser::raiseError(): XML_Parser::raiseError()
XML_Parser::reset(): Reset the parser.
XML_Parser::setInput(): Sets the file handle to use with parse().
XML_Parser::setInputFile(): Sets the input xml file to be parsed
XML_Parser::setInputString(): XML_Parser::setInputString()
XML_Parser::setMode(): Sets the mode of the parser.
XML_Parser::startHandler()

Class Details

[line 79]
Simple XML parser class.

This class is a simplified version of XML_Parser. In most XML applications the real action is executed, when a closing tag is found.

XML_Parser_Simple allows you to just implement one callback for each tag that will receive the tag with its attributes and CData.

 require_once '../Parser/Simple.php';

 
 class myParser extends XML_Parser_Simple
 {
     function myParser()
     {
        $this->XML_Parser_Simple();
      }
 
    function handleElement($name, $attribs, $data)
     {
         printf('handle %s<br>', $name);
     }
 }
 
 $p = &new myParser();
 
 $result = $p->setInputFile('myDoc.xml');
 $result = $p->parse();

Author: Stephan Schmidt <schst@php-tools.net>

[ Top ]

Method Detail

XML_Parser_Simple (Constructor) [line 118]

XML_Parser_Simple XML_Parser_Simple(
[string
$srcenc = null], [string
$mode = 'event'], [
$tgtenc = null], string
$tgenc)

Creates an XML parser.

This is needed for PHP4 compatibility, it will call the constructor, when a new instance is created.

Parameters:

string	`$srcenc`	—	source charset encoding, use NULL (default) to use whatever the document specifies
string	`$mode`	—	how this parser object should work, "event" for handleElement(), "func" to have it call functions named after elements (handleElement_$name())
string	`$tgenc`	—	a valid target encoding
	`$tgtenc`	—

[ Top ]

addToData [line 270]

void addToData(
string
$data)

add some string to the current ddata.

This is commonly needed, when a document is parsed recursively.

Access: public

Parameters:

string $data — data to add

[ Top ]

getCurrentDepth [line 256]

integer getCurrentDepth(
)

get the current tag depth

The root tag is in depth 0.

Access: public

[ Top ]

handleElement [line 244]

void handleElement(
string
$name, array
$attribs, string
$data)

handle a tag

Implement this in your parser

Abstract:
Access: public

Parameters:

string	`$name`	—	element name
array	`$attribs`	—	attributes
string	`$data`	—	character data

[ Top ]

reset [line 157]

boolean|object reset(
)

Reset the parser.

This allows you to use one parser instance to parse multiple XML documents.

Return: true on success, PEAR_Error otherwise
Access: public

Overrides XML_Parser::reset() (Reset the parser.)

[ Top ]