PHP | xml_set_character_data_handler() Function

Last Updated : 07 Aug, 2021

The xml_set_character_data_handler() function is an inbuilt function in PHP which is used to set the character data handler function for XML parser.

Syntax:

bool xml_set_character_data_handler( resource $xml_parser, callable $data_handler )

Parameters: This function accepts two parameters as mentioned above and described below:

$xml_parser: It is required parameter. It holds the reference of XML parser to set up character data handler.
$data_handler: It is required parameter. It is a string which contains the name of function.

handler( resource $parser, string $data )

The handler function must have these two parameters:

$xml_parser: It holds the reference of XML parser which is calling to handler.
$data: It holds the character data as a string.

Return Value: This function returns True on success or False on failure.

Note:

This function is available for PHP 4.0.0 and newer version.
These examples may not work on online IDE. So, try to run it on local server or php hosted servers.

gfg.xml file:

XML

<?xml version="1.0" encoding="utf-8"?>
<user>
    <username> user123 </username>
    <name> firstname lastname </name>
    <phone> +91-9876543210 </phone>
    <detail> I am John Doe. Live in Kolkata, India. </detail>
</user>

Program 1:

PHP

<?php

// Create an XML parser
$xml_parser = xml_parser_create();
 
// Set the character handler function for XML parser
xml_set_character_data_handler($xml_parser, "char_print");

// Opening xml file
$file_pointer = fopen("gfg.xml", "r");

// Reading xml data from file
while($data = fread($file_pointer, 4096)) {
    
    // Parsing XML data
    xml_parse($xml_parser, $data, feof($file_pointer)) or
    
    // Display error when parsing error occurs
    die (sprintf("XML Error: %s at line %d",
        
        // Error string
        xml_error_string(xml_get_error_code($xml_parser)),
        
        // Current line
        xml_get_current_line_number($xml_parser)));
}

// Free to xml parser
xml_parser_free($xml_parser);

fclose($file_pointer);
 
// Character handler function for XML parser
function char_print($xml_parser, $data_to_print) {
    echo $data_to_print;
}
 
?>

Output:

user123 
firstname lastname 
+91-9876543210 
I am John Doe. Live in Kolkata, India.

Program 2:

PHP

<?php

// Create an xml parser
$xml_parser = xml_parser_create();

// Element handler function named "starting_handler"
// enables custom manipulation for output
function starting_handler($xml_parser,
            $element_name, $element_attrs) {
    
    switch($element_name) {
        case "USER":
            echo "<u>USER DATA</u><br>";
            break;
        case "USERNAME":
            echo "Username: ";
            break;
        case "NAME":
            echo "Name: ";
            break;
        case "PHONE":
            echo "Phone no: ";
            break;
        case "DETAIL":
            echo "More about user: ";
    }
}

// Element handler function named "ending_handler"
function ending_handler($xml_parser, $element_name) {
    echo "<br>";
}

// Character handler function named "char_handler"
function char_handler($xml_parser, $data) {
    echo $data;
}

// Setting element handlers
xml_set_element_handler($xml_parser,
        "starting_handler", "ending_handler");

// Setting character data handler
xml_set_character_data_handler($xml_parser, "char_handler");

// Opening xml file
$file_pointer = fopen("gfg.xml", "r");

// Reading xml file 
while ($data = fread($file_pointer, 4096)) {
    xml_parse($xml_parser, $data, feof($file_pointer)) or
    
    // Display error while xml parsing
    die (sprintf("XML Error: %s at line %d",
    
        // Error string
        xml_error_string(xml_get_error_code($xml_parser)),
        
        // Error line number
        xml_get_current_line_number($xml_parser)));
}

// Free to xml parser
xml_parser_free($xml_parser);

// Closing file stream
fclose($file_pointer);

?>

Output:

USER DATA
Username: user123
Name: firstname lastname
Phone no: +91-9876543210
More about user: I am John Doe. Live in Kolkata, India.

Reference: https://www.php.net/manual/en/function.xml-set-character-data-handler.php

PHP | xml_set_character_data_handler() Function

gekcho

Improve

Article Tags :

PHP | xml_set_character_data_handler() Function

Similar Reads

Thank You!

What kind of Experience do you want to share?