Web студия "GrandView"

Description

bool xml_set_character_data_handler ( resource parser, callback handler )

Sets the character data handler function for the XML parser parser.handler is a string containing the name of a function that must exist when xml_parse() is called for parser.

The function named by handler must accept two parameters: handler ( resource parser, string data )

parser: The first parameter, parser, is a reference to the XML parser calling the handler.
data: The second parameter, data, contains the character data as a string.

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

TRUE is returned if the handler is set up, FALSE if parser is not a parser.

Замечание: В качестве аргумента вместо имени функции может быть передан массив, содержащий ссылку на объект и имя метода.

add a note User Contributed Notes
xml_set_character_data_handler

unspammable-iain at iaindooley dot com
03-Jan-2006 01:41


re: jason at omegavortex dot com below, another way to deal with whitespace issues is:



        function charData($parser,$data)

        {

            $char_data = trim($data);



            if($char_data)

                $char_data = preg_replace('/  */',' ',$data);



            $this->cdata .= $char_data;

        }



This means that:



    <p>here is my text <a href="something">my text</a> 

    and here is some more after some spaces at the

    beginning of the line</p>



comes out properly. You could do further replacements if you want to deal with tabs in your files. i only ever use spaces. if you only use trim() then you would lose the space before the <a> tag above, but trim() is a good way to check for completely empty char data, then just replace more than one space with a single space. this will preserve a single space at the beginning and end of the cdata.

jason at omegavortex dot com
06-Dec-2005 11:00


I don't believe the problem has been addressed, but if you're parsing an XML file and run into the line break (or tab) problem I believe this function may help:



if (!preg_match("/((\r|)\n)/i", $data) || preg_match("/\\t+/i", $data)) {

(Code Here)

}

wako057 at gmx dot fr
22-Aug-2005 09:39


That give an example about the note.

When you are creating a class and you need to use a method of your class to the function xml_set_character_data_handler that is the way to point give the method:



class example

{

   function example()

   {

   }



  function data($parseur, $texte)

  {

      switch ($this->derniereBaliseRencontree) 

      {

         case "TITLE":

                     -----

          break;

         case "LINK"

                    -----

         break;

        case "DESCRIPTION":

                    -----

        break;

     }

  }



  function fetchOpen($parseur, $nomBalise, $tableauAttributs)

  {

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

  }



  function fetchClose($parseur, $nomBalise)

  {

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

  }



  function ZZZ()

  {

      $parseurXML = xml_parser_create();

       xml_set_element_handler($parseurXML, Array(&$this, 'fetchOpen'),   Array(&$this, 'fetchClose'));

         ---------------- <IMPORTANT> --------------------------

       xml_set_character_data_handler($parseurXML, Array(&$this, 'data'));

        ---------------- </IMPORTANT> --------------------------

}

ben at removethis emediastudios dotcom
05-Aug-2005 03:53


I too love the undocumented "splitting" functionality :-p.



Rather than concatinating the data based on whether or not the current tag name has changed from the previous tag name I suggest always concatinating like the following with the $catData variable being unset in the endElement function:



<?php



function endElement ($parser, $data) {

  global $catData;



  // Because we are at an element end we know any splitting is finished

  unset($GLOBALS['catData']);

}



function characterData ($parser, $data) {

  global $catData;



  // Concatinate data in case splitting is taking place

  $catData.=$data;



}



?>



This got me around a problem with data like the following where, because characterData is not called for empty tags, the previous and current tag names were the same even though splitting was not taking place.



<companydept>

<companydeptID></companydeptID>

<companyID>1</companyID>

<companydeptName></companydeptName>

</companydept>

<companydept>

<companydeptID></companydeptID>

<companyID>2</companyID>

<companydeptName></companydeptName>

</companydept>

<companydept>

<companydeptID></companydeptID>

<companyID>3</companyID>

<companydeptName></companydeptName>

</companydept>

yaroukh at email dot cz
25-Apr-2005 08:51


It would be nice if someone could complete documentation of this function. I think that the "splitting" behaviour should (at least) be mentioned within the documentation, if not explained (please!). I'm not quite sure whether the cut comes after each 1024bytes/chars of data.



My experience looks as follows:

[xmlFile]

...

    <label>slo|