mirror of
https://github.com/EGroupware/egroupware.git
synced 2024-12-15 19:20:47 +01:00
3384 lines
116 KiB
PHP
3384 lines
116 KiB
PHP
<?php
|
|
|
|
//
|
|
// +----------------------------------------------------------------------+
|
|
// | <phpXML/> version 1.0 |
|
|
// | Copyright (c) 2001 Michael P. Mehl. All rights reserved. |
|
|
// +----------------------------------------------------------------------+
|
|
// | Latest releases are available at http://phpxml.org/. For feedback or |
|
|
// | bug reports, please contact the author at mpm@phpxml.org. Thanks! |
|
|
// +----------------------------------------------------------------------+
|
|
// | The contents of this file are subject to the Mozilla Public License |
|
|
// | Version 1.1 (the "License"); you may not use this file except in |
|
|
// | compliance with the License. You may obtain a copy of the License at |
|
|
// | http://www.mozilla.org/MPL/ |
|
|
// | |
|
|
// | Software distributed under the License is distributed on an "AS IS" |
|
|
// | basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See |
|
|
// | the License for the specific language governing rights and |
|
|
// | limitations under the License. |
|
|
// | |
|
|
// | The Original Code is <phpXML/>. |
|
|
// | |
|
|
// | The Initial Developer of the Original Code is Michael P. Mehl. |
|
|
// | Portions created by Michael P. Mehl are Copyright (C) 2001 Michael |
|
|
// | P. Mehl. All Rights Reserved. |
|
|
// +----------------------------------------------------------------------+
|
|
// | Authors: |
|
|
// | Michael P. Mehl <mpm@phpxml.org> |
|
|
// +----------------------------------------------------------------------+
|
|
//
|
|
|
|
/**
|
|
* Class for accessing XML data through the XPath language.
|
|
*
|
|
* This class offers methods for accessing the nodes of a XML document using
|
|
* the XPath language. You can add or remove nodes, set or modify their
|
|
* content and their attributes. No additional PHP extensions like DOM XML
|
|
* or something similar are required to use these features.
|
|
*
|
|
* @link http://www.phpxml.org/ Latest release of this class
|
|
* @link http://www.w3.org/TR/xpath W3C XPath Recommendation
|
|
* @copyright Copyright (c) 2001 Michael P. Mehl. All rights reserved.
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @version 1.0 (2001-03-08)
|
|
* @access public
|
|
*/
|
|
|
|
class XML
|
|
{
|
|
/**
|
|
* List of all document nodes.
|
|
*
|
|
* This array contains a list of all document nodes saved as an
|
|
* associative array.
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $nodes = array();
|
|
|
|
/**
|
|
* List of document node IDs.
|
|
*
|
|
* This array contains a list of all IDs of all document nodes that
|
|
* are used for counting when adding a new node.
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $ids = array();
|
|
|
|
/**
|
|
* Current document path.
|
|
*
|
|
* This variable saves the current path while parsing a XML file and adding
|
|
* the nodes being read from the file.
|
|
*
|
|
* @access private
|
|
* @var string
|
|
*/
|
|
var $path = "";
|
|
|
|
/**
|
|
* Current document position.
|
|
*
|
|
* This variable counts the current document position while parsing a XML
|
|
* file and adding the nodes being read from the file.
|
|
*
|
|
* @access private
|
|
* @var int
|
|
*/
|
|
var $position = 0;
|
|
|
|
/**
|
|
* Path of the document root.
|
|
*
|
|
* This string contains the full path to the node that acts as the root
|
|
* node of the whole document.
|
|
*
|
|
* @access private
|
|
* @var string
|
|
*/
|
|
var $root = "";
|
|
|
|
/**
|
|
* Current XPath expression.
|
|
*
|
|
* This string contains the full XPath expression being parsed currently.
|
|
*
|
|
* @access private
|
|
* @var string
|
|
*/
|
|
var $xpath = "";
|
|
|
|
/**
|
|
* List of entities to be converted.
|
|
*
|
|
* This array contains a list of entities to be converted when an XPath
|
|
* expression is evaluated.
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $entities = array ( "&" => "&", "<" => "<", ">" => ">",
|
|
"'" => "&apos", '"' => """ );
|
|
|
|
/**
|
|
* List of supported XPath axes.
|
|
*
|
|
* This array contains a list of all valid axes that can be evaluated in an
|
|
* XPath expression.
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $axes = array ( "child", "descendant", "parent", "ancestor",
|
|
"following-sibling", "preceding-sibling", "following", "preceding",
|
|
"attribute", "namespace", "self", "descendant-or-self",
|
|
"ancestor-or-self" );
|
|
|
|
/**
|
|
* List of supported XPath functions.
|
|
*
|
|
* This array contains a list of all valid functions that can be evaluated
|
|
* in an XPath expression.
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $functions = array ( "last", "position", "count", "id", "name",
|
|
"string", "concat", "starts-with", "contains", "substring-before",
|
|
"substring-after", "substring", "string-length", "translate",
|
|
"boolean", "not", "true", "false", "lang", "number", "sum", "floor",
|
|
"ceiling", "round", "text" );
|
|
|
|
/**
|
|
* List of supported XPath operators.
|
|
*
|
|
* This array contains a list of all valid operators that can be evaluated
|
|
* in a predicate of an XPath expression. The list is ordered by the
|
|
* precedence of the operators (lowest precedence first).
|
|
*
|
|
* @access private
|
|
* @var array
|
|
*/
|
|
var $operators = array( " or ", " and ", "=", "!=", "<=", "<", ">=", ">",
|
|
"+", "-", "*", " div ", " mod " );
|
|
|
|
/**
|
|
* Constructor of the class.
|
|
*
|
|
* This constructor initializes the class and, when a filename is given,
|
|
* tries to read and parse the given file.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $file Path and name of the file to read and parsed.
|
|
* @see load_file()
|
|
*/
|
|
function XML ( $file = "" )
|
|
{
|
|
// Check whether a file was given.
|
|
if ( !empty($file) )
|
|
{
|
|
// Load the XML file.
|
|
$this->load_file($file);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Reads a file and parses the XML data.
|
|
*
|
|
* This method reads the content of a XML file, tries to parse its
|
|
* content and upon success stores the information retrieved from
|
|
* the file into an array.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $file Path and name of the file to be read and parsed.
|
|
* @see handle_start_element(), handle_end_element(),
|
|
* handle_character_data()
|
|
*/
|
|
function load_file ( $file )
|
|
{
|
|
// Check whether the file exists and is readable.
|
|
if ( file_exists($file) && is_readable($file) )
|
|
{
|
|
// Read the content of the file.
|
|
$content = implode("", file($file));
|
|
|
|
// Check whether content has been read.
|
|
if ( !empty($content) )
|
|
{
|
|
// Create an XML parser.
|
|
$parser = xml_parser_create();
|
|
|
|
// Set the options for parsing the XML data.
|
|
xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE, 1);
|
|
xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING, 0);
|
|
|
|
// Set the object for the parser.
|
|
xml_set_object($parser, &$this);
|
|
|
|
// Set the element handlers for the parser.
|
|
xml_set_element_handler($parser, "handle_start_element",
|
|
"handle_end_element");
|
|
xml_set_character_data_handler($parser,
|
|
"handle_character_data");
|
|
|
|
// Parse the XML file.
|
|
if ( !xml_parse($parser, $content, true) )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("XML error in file %s, line %d: %s",
|
|
$file, xml_get_current_line_number($parser),
|
|
xml_error_string(xml_get_error_code($parser)));
|
|
}
|
|
|
|
// Free the parser.
|
|
xml_parser_free($parser);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("File %s could not be found or read.", $file);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Generates a XML file with the content of the current document.
|
|
*
|
|
* This method creates a string containing the XML data being read
|
|
* and modified by this class before. This string can be used to save
|
|
* a modified document back to a file or doing other nice things with
|
|
* it.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $highlight Array containing a list of full document
|
|
* paths of nodes to be highlighted by <font>...</font> tags
|
|
* in the generated XML string.
|
|
* @param string $root While doing a recursion with this method, this
|
|
* parameter is used for internal purpose.
|
|
* @param int $level While doing a recursion with this method, this
|
|
* parameter is used for internal purpose.
|
|
* @return string The returned string contains well-formed XML data
|
|
* representing the content of this document.
|
|
* @see load_file(), evaluate(), get_content()
|
|
*/
|
|
function get_file ( $highlight = array(), $root = "", $level = 0 )
|
|
{
|
|
// Create a string to save the generated XML data.
|
|
$xml = "";
|
|
|
|
// Create two strings containing the tags for highlighting a node.
|
|
$highlight_start = "<font color=\"#FF0000\"><b>";
|
|
$highlight_end = "</b></font>";
|
|
|
|
// Generate a string to be displayed before the tags.
|
|
$before = "";
|
|
|
|
// Calculate the amount of whitespaces to display.
|
|
for ( $i = 0; $i < ( $level * 2 ); $i++ )
|
|
{
|
|
// Add a whitespaces to the string.
|
|
$before .= " ";
|
|
}
|
|
|
|
// Check whether a root node is given.
|
|
if ( empty($root) )
|
|
{
|
|
// Set it to the document root.
|
|
$root = $this->root;
|
|
}
|
|
|
|
// Check whether the node is selected.
|
|
$selected = in_array($root, $highlight);
|
|
|
|
// Now add the whitespaces to the XML data.
|
|
$xml .= $before;
|
|
|
|
// Check whether the node is selected.
|
|
if ( $selected )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_start;
|
|
}
|
|
|
|
// Now open the tag.
|
|
$xml .= "<".$this->nodes[$root]["name"];
|
|
|
|
// Check whether there are attributes for this node.
|
|
if ( count($this->nodes[$root]["attributes"]) > 0 )
|
|
{
|
|
// Run through all attributes.
|
|
foreach ( $this->nodes[$root]["attributes"] as $key => $value )
|
|
{
|
|
// Check whether this attribute is highlighted.
|
|
if ( in_array($root."/attribute::".$key, $highlight) )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_start;
|
|
}
|
|
|
|
// Add the attribute to the XML data.
|
|
$xml .= " ".$key."=\"".trim(stripslashes($value))."\"";
|
|
|
|
// Check whether this attribute is highlighted.
|
|
if ( in_array($root."/attribute::".$key, $highlight) )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_end;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether the node contains character data or has children.
|
|
if ( empty($this->nodes[$root]["text"]) &&
|
|
!isset($this->nodes[$root]["children"]) )
|
|
{
|
|
// Add the end to the tag.
|
|
$xml .= "/";
|
|
}
|
|
|
|
// Close the tag.
|
|
$xml .= ">\n";
|
|
|
|
// Check whether the node is selected.
|
|
if ( $selected )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_end;
|
|
}
|
|
|
|
// Check whether the node contains character data.
|
|
if ( !empty($this->nodes[$root]["text"]) )
|
|
{
|
|
// Add the character data to the XML data.
|
|
$xml .= $before." ".$this->nodes[$root]["text"]."\n";
|
|
}
|
|
|
|
// Check whether the node has children.
|
|
if ( isset($this->nodes[$root]["children"]) )
|
|
{
|
|
// Run through all children with different names.
|
|
foreach ( $this->nodes[$root]["children"] as $child => $pos )
|
|
{
|
|
// Run through all children with the same name.
|
|
for ( $i = 1; $i <= $pos; $i++ )
|
|
{
|
|
// Generate the full path of the child.
|
|
$fullchild = $root."/".$child."[".$i."]";
|
|
|
|
// Add the child's XML data to the existing data.
|
|
$xml .= $this->get_file($highlight, $fullchild,
|
|
$level + 1);
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether there are attributes for this node.
|
|
if ( !empty($this->nodes[$root]["text"]) ||
|
|
isset($this->nodes[$root]["children"]) )
|
|
{
|
|
// Add the whitespaces to the XML data.
|
|
$xml .= $before;
|
|
|
|
// Check whether the node is selected.
|
|
if ( $selected )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_start;
|
|
}
|
|
|
|
// Add the closing tag.
|
|
$xml .= "</".$this->nodes[$root]["name"].">";
|
|
|
|
// Check whether the node is selected.
|
|
if ( $selected )
|
|
{
|
|
// Add the highlight code to the XML data.
|
|
$xml .= $highlight_end;
|
|
}
|
|
|
|
// Add a linebreak.
|
|
$xml .= "\n";
|
|
}
|
|
|
|
// Return the XML data.
|
|
return $xml;
|
|
}
|
|
|
|
/**
|
|
* Adds a new node to the XML document.
|
|
*
|
|
* This method adds a new node to the tree of nodes of the XML document
|
|
* being handled by this class. The new node is created according to the
|
|
* parameters passed to this method.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $content Full path of the parent, to which the new
|
|
* node should be added as a child.
|
|
* @param string $name Name of the new node.
|
|
* @return string The string returned by this method will contain the
|
|
* full document path of the created node.
|
|
* @see remove_node(), evaluate()
|
|
*/
|
|
function add_node ( $context, $name )
|
|
{
|
|
// Check whether a name for this element is already set.
|
|
if ( empty($this->root) )
|
|
{
|
|
// Use this tag as the root element.
|
|
$this->root = "/".$name."[1]";
|
|
}
|
|
|
|
// Calculate the full path for this element.
|
|
$path = $context."/".$name;
|
|
|
|
// Set the relative context and the position.
|
|
$position = ++$this->ids[$path];
|
|
$relative = $name."[".$position."]";
|
|
|
|
// Calculate the full path.
|
|
$fullpath = $context."/".$relative;
|
|
|
|
// Calculate the context position, which is the position of this
|
|
// element within elements of the same name in the parent node.
|
|
$this->nodes[$fullpath]["context-position"] = $position;
|
|
|
|
// Calculate the position for the following and preceding axis
|
|
// detection.
|
|
$this->nodes[$fullpath]["document-position"] =
|
|
$this->nodes[$context]["document-position"] + 1;
|
|
|
|
// Save the information about the node.
|
|
$this->nodes[$fullpath]["name"] = $name;
|
|
$this->nodes[$fullpath]["text"] = "";
|
|
$this->nodes[$fullpath]["parent"] = $context;
|
|
|
|
// Add this element to the element count array.
|
|
if ( !$this->nodes[$context]["children"][$name] )
|
|
{
|
|
// Set the default name.
|
|
$this->nodes[$context]["children"][$name] = 1;
|
|
}
|
|
else
|
|
{
|
|
// Calculate the name.
|
|
$this->nodes[$context]["children"][$name] =
|
|
$this->nodes[$context]["children"][$name] + 1;
|
|
}
|
|
|
|
// Return the path of the new node.
|
|
return $fullpath;
|
|
}
|
|
|
|
/**
|
|
* Removes a node from the XML document.
|
|
*
|
|
* This method removes a node from the tree of nodes of the XML document.
|
|
* If the node is a document node, all children of the node and its
|
|
* character data will be removed. If the node is an attribute node,
|
|
* only this attribute will be removed, the node to which the attribute
|
|
* belongs as well as its children will remain unmodified.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node to be removed.
|
|
* @see add_node(), evaluate()
|
|
*/
|
|
function remove_node ( $node )
|
|
{
|
|
// Check whether the node is an attribute node.
|
|
if ( ereg("/attribute::", $node) )
|
|
{
|
|
// Get the path to the attribute node's parent.
|
|
$parent = $this->prestr($node, "/attribute::");
|
|
|
|
// Get the name of the attribute.
|
|
$attribute = $this->afterstr($node, "/attribute::");
|
|
|
|
// Check whether the attribute exists.
|
|
if ( isset($this->nodes[$parent]["attributes"][$attribute]) )
|
|
{
|
|
// Create a new array.
|
|
$new = array();
|
|
|
|
// Run through the existing attributes.
|
|
foreach ( $this->nodes[$parent]["attributes"]
|
|
as $key => $value )
|
|
{
|
|
// Check whether it's the attribute to remove.
|
|
if ( $key != $attribute )
|
|
{
|
|
// Add it to the new array again.
|
|
$new[$key] = $value;
|
|
}
|
|
}
|
|
|
|
// Save the new attributes.
|
|
$this->nodes[$parent]["attributes"] = $new;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Create an associative array, which contains information about
|
|
// all nodes that required to be renamed.
|
|
$rename = array();
|
|
|
|
// Get the name, the parent and the siblings of current node.
|
|
$name = $this->nodes[$node]["name"];
|
|
$parent = $this->nodes[$node]["parent"];
|
|
$siblings = $this->nodes[$parent]["children"][$name];
|
|
|
|
// Decrease the number of children.
|
|
$this->nodes[$parent]["children"][$name]--;
|
|
|
|
// Create a counter for renumbering the siblings.
|
|
$counter = 1;
|
|
|
|
// Now run through the siblings.
|
|
for ( $i = 1; $i <= $siblings; $i++ )
|
|
{
|
|
// Create the name of the sibling.
|
|
$sibling = $parent."/".$name."[".$i."]";
|
|
|
|
// Check whether it's the name of the current node.
|
|
if ( $sibling != $node )
|
|
{
|
|
// Create the new name for the sibling.
|
|
$new = $parent."/".$name."[".$counter."]";
|
|
|
|
// Increase the counter.
|
|
$counter++;
|
|
|
|
// Add the old and the new name to the list of nodes
|
|
// to be renamed.
|
|
$rename[$sibling] = $new;
|
|
}
|
|
}
|
|
|
|
// Create an array for saving the new node-list.
|
|
$nodes = array();
|
|
|
|
// Now run through through the existing nodes.
|
|
foreach ( $this->nodes as $name => $values )
|
|
{
|
|
// Check the position of the path of the node to be deleted
|
|
// in the path of the current node.
|
|
$position = strpos($name, $node);
|
|
|
|
// Check whether it's not the node to be deleted.
|
|
if ( $position === false )
|
|
{
|
|
// Run through the array of nodes to be renamed.
|
|
foreach ( $rename as $old => $new )
|
|
{
|
|
// Check whether this node and it's parent requires to
|
|
// be renamed.
|
|
$name = str_replace($old, $new, $name);
|
|
$values["parent"] = str_replace($old, $new,
|
|
$values["parent"]);
|
|
}
|
|
|
|
// Add the node to the list of nodes.
|
|
$nodes[$name] = $values;
|
|
}
|
|
}
|
|
|
|
// Save the new array of nodes.
|
|
$this->nodes = $nodes;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add content to a node.
|
|
*
|
|
* This method adds content to a node. If it's an attribute node, then
|
|
* the value of the attribute will be set, otherwise the character data of
|
|
* the node will be set. The content is appended to existing content,
|
|
* so nothing will be overwritten.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node.
|
|
* @param string $value String containing the content to be added.
|
|
* @see get_content(), evaluate()
|
|
*/
|
|
function add_content ( $path, $value )
|
|
{
|
|
// Check whether it's an attribute node.
|
|
if ( ereg("/attribute::", $path) )
|
|
{
|
|
// Get the path to the attribute node's parent.
|
|
$parent = $this->prestr($path, "/attribute::");
|
|
|
|
// Get the parent node.
|
|
$parent = $this->nodes[$parent];
|
|
|
|
// Get the name of the attribute.
|
|
$attribute = $this->afterstr($path, "/attribute::");
|
|
|
|
// Set the attribute.
|
|
$parent["attributes"][$attribute] .= $value;
|
|
}
|
|
else
|
|
{
|
|
// Set the character data of the node.
|
|
$this->nodes[$path]["text"] .= $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Set the content of a node.
|
|
*
|
|
* This method sets the content of a node. If it's an attribute node, then
|
|
* the value of the attribute will be set, otherwise the character data of
|
|
* the node will be set. Existing content will be overwritten.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node.
|
|
* @param string $value String containing the content to be set.
|
|
* @see get_content(), evaluate()
|
|
*/
|
|
function set_content ( $path, $value )
|
|
{
|
|
// Check whether it's an attribute node.
|
|
if ( ereg("/attribute::", $path) )
|
|
{
|
|
// Get the path to the attribute node's parent.
|
|
$parent = $this->prestr($path, "/attribute::");
|
|
|
|
// Get the parent node.
|
|
$parent = $this->nodes[$parent];
|
|
|
|
// Get the name of the attribute.
|
|
$attribute = $this->afterstr($path, "/attribute::");
|
|
|
|
// Set the attribute.
|
|
$parent["attributes"][$attribute] = $value;
|
|
}
|
|
else
|
|
{
|
|
// Set the character data of the node.
|
|
$this->nodes[$path]["text"] = $value;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Retrieves the content of a node.
|
|
*
|
|
* This method retrieves the content of a node. If it's an attribute
|
|
* node, then the value of the attribute will be retrieved, otherwise
|
|
* it'll be the character data of the node.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node, from which the
|
|
* content should be retrieved.
|
|
* @return string The returned string contains either the value or the
|
|
* character data of the node.
|
|
* @see set_content(), evaluate()
|
|
*/
|
|
function get_content ( $path )
|
|
{
|
|
// Check whether it's an attribute node.
|
|
if ( ereg("/attribute::", $path) )
|
|
{
|
|
// Get the path to the attribute node's parent.
|
|
$parent = $this->prestr($path, "/attribute::");
|
|
|
|
// Get the parent node.
|
|
$parent = $this->nodes[$parent];
|
|
|
|
// Get the name of the attribute.
|
|
$attribute = $this->afterstr($path, "/attribute::");
|
|
|
|
// Get the attribute.
|
|
$attribute = $parent["attributes"][$attribute];
|
|
|
|
// Return the value of the attribute.
|
|
return $attribute;
|
|
}
|
|
else
|
|
{
|
|
// Return the cdata of the node.
|
|
return stripslashes($this->nodes[$path]["text"]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add attributes to a node.
|
|
*
|
|
* This method adds attributes to a node. Existing attributes will not be
|
|
* overwritten.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node, the attributes
|
|
* should be added to.
|
|
* @param array $attributes Associative array containing the new
|
|
* attributes for the node.
|
|
* @see set_content(), get_content()
|
|
*/
|
|
function add_attributes ( $path, $attributes )
|
|
{
|
|
// Add the attributes to the node.
|
|
$this->nodes[$path]["attributes"] = array_merge($attributes,
|
|
$this->nodes[$path]["attributes"]);
|
|
}
|
|
|
|
/**
|
|
* Sets the attributes of a node.
|
|
*
|
|
* This method sets the attributes of a node and overwrites all existing
|
|
* attributes by doing this.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node, the attributes
|
|
* of which should be set.
|
|
* @param array $attributes Associative array containing the new
|
|
* attributes for the node.
|
|
* @see set_content(), get_content()
|
|
*/
|
|
function set_attributes ( $path, $attributes )
|
|
{
|
|
// Set the attributes of the node.
|
|
$this->nodes[$path]["attributes"] = $attributes;
|
|
}
|
|
|
|
/**
|
|
* Retrieves a list of all attributes of a node.
|
|
*
|
|
* This method retrieves a list of all attributes of the node specified in
|
|
* the argument.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node, from which the
|
|
* list of attributes should be retrieved.
|
|
* @return array The returned associative array contains the all
|
|
* attributes of the specified node.
|
|
* @see get_content(), $nodes, $ids
|
|
*/
|
|
function get_attributes ( $path )
|
|
{
|
|
// Return the attributes of the node.
|
|
return $this->nodes[$path]["attributes"];
|
|
}
|
|
|
|
/**
|
|
* Retrieves the name of a document node.
|
|
*
|
|
* This method retrieves the name of document node specified in the
|
|
* argument.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path Full document path of the node, from which the
|
|
* name should be retrieved.
|
|
* @return string The returned array contains the name of the specified
|
|
* node.
|
|
* @see get_content(), $nodes, $ids
|
|
*/
|
|
function get_name ( $path )
|
|
{
|
|
// Return the name of the node.
|
|
return $this->nodes[$path]["name"];
|
|
}
|
|
|
|
/**
|
|
* Evaluates an XPath expression.
|
|
*
|
|
* This method tries to evaluate an XPath expression by parsing it. A
|
|
* XML document has to be read before this method is able to work.
|
|
*
|
|
* @access public
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $path XPath expression to be evaluated.
|
|
* @param string $context Full path of a document node, starting
|
|
* from which the XPath expression should be evaluated.
|
|
* @return array The returned array contains a list of the full
|
|
* document paths of all nodes that match the evaluated
|
|
* XPath expression.
|
|
* @see $nodes, $ids
|
|
*/
|
|
function evaluate ( $path, $context = "" )
|
|
{
|
|
// Remove slashes and quote signs.
|
|
$path = stripslashes($path);
|
|
$path = str_replace("\"", "", $path);
|
|
$path = str_replace("'", "", $path);
|
|
|
|
// Split the paths into different paths.
|
|
$paths = $this->split_paths($path);
|
|
|
|
// Create an empty set to save the result.
|
|
$result = array();
|
|
|
|
// Run through all paths.
|
|
foreach ( $paths as $path )
|
|
{
|
|
// Trim the path.
|
|
$path = trim($path);
|
|
|
|
// Save the current path.
|
|
$this->xpath = $path;
|
|
|
|
// Convert all entities.
|
|
$path = strtr($path, array_flip($this->entities));
|
|
|
|
// Split the path at every slash.
|
|
$steps = $this->split_steps($path);
|
|
|
|
// Check whether the first element is empty.
|
|
if ( empty($steps[0]) )
|
|
{
|
|
// Remove the first and empty element.
|
|
array_shift($steps);
|
|
}
|
|
|
|
// Start to evaluate the steps.
|
|
$nodes = $this->evaluate_step($context, $steps);
|
|
|
|
// Remove duplicated nodes.
|
|
$nodes = array_unique($nodes);
|
|
|
|
// Add the nodes to the result set.
|
|
$result = array_merge($result, $nodes);
|
|
}
|
|
|
|
// Return the result.
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Handles opening XML tags while parsing.
|
|
*
|
|
* While parsing a XML document for each opening tag this method is
|
|
* called. It'll add the tag found to the tree of document nodes.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param int $parser Handler for accessing the current XML parser.
|
|
* @param string $name Name of the opening tag found in the document.
|
|
* @param array $attributes Associative array containing a list of
|
|
* all attributes of the tag found in the document.
|
|
* @see handle_end_element(), handle_character_data(), $nodes, $ids
|
|
*/
|
|
function handle_start_element ( $parser, $name, $attributes )
|
|
{
|
|
// Add a node.
|
|
$this->path = $this->add_node($this->path, $name);
|
|
|
|
// Set the attributes.
|
|
$this->set_attributes($this->path, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Handles closing XML tags while parsing.
|
|
*
|
|
* While parsing a XML document for each closing tag this method is
|
|
* called.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param int $parser Handler for accessing the current XML parser.
|
|
* @param string $name Name of the closing tag found in the document.
|
|
* @see handle_start_element(), handle_character_data(), $nodes, $ids
|
|
*/
|
|
function handle_end_element ( $parser, $name )
|
|
{
|
|
// Jump back to the parent element.
|
|
$this->path = substr($this->path, 0, strrpos($this->path, "/"));
|
|
}
|
|
|
|
/**
|
|
* Handles character data while parsing.
|
|
*
|
|
* While parsing a XML document for each character data this method
|
|
* is called. It'll add the character data to the document tree.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param int $parser Handler for accessing the current XML parser.
|
|
* @param string $text Character data found in the document.
|
|
* @see handle_start_element(), handle_end_element(), $nodes, $ids
|
|
*/
|
|
function handle_character_data ( $parser, $text )
|
|
{
|
|
// Replace entities.
|
|
$text = strtr($text, $this->entities);
|
|
|
|
// Save the text.
|
|
$this->add_content($this->path, addslashes(trim($text)));
|
|
}
|
|
|
|
/**
|
|
* Splits an XPath expression into its different expressions.
|
|
*
|
|
* This method splits an XPath expression. Each expression can consists of
|
|
* list of expression being separated from each other by a | character.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $expression The complete expression to be splitted
|
|
* into its different expressions.
|
|
* @return array The array returned from this method contains a list
|
|
* of all expressions found in the expression passed to this
|
|
* method as a parameter.
|
|
* @see evalute()
|
|
*/
|
|
function split_paths ( $expression )
|
|
{
|
|
// Create an empty array.
|
|
$paths = array();
|
|
|
|
// Save the position of the slash.
|
|
$position = -1;
|
|
|
|
// Run through the expression.
|
|
do
|
|
{
|
|
// Search for a slash.
|
|
$position = $this->search_string($expression, "|");
|
|
|
|
// Check whether a | was found.
|
|
if ( $position >= 0 )
|
|
{
|
|
// Get the left part of the expression.
|
|
$left = substr($expression, 0, $position);
|
|
$right = substr($expression, $position + 1);
|
|
|
|
// Add the left value to the steps.
|
|
$paths[] = $left;
|
|
|
|
// Reduce the expression to the right part.
|
|
$expression = $right;
|
|
}
|
|
}
|
|
while ( $position > -1 );
|
|
|
|
// Add the remaing expression to the list of steps.
|
|
$paths[] = $expression;
|
|
|
|
// Return the steps.
|
|
return $paths;
|
|
}
|
|
|
|
/**
|
|
* Splits an XPath expression into its different steps.
|
|
*
|
|
* This method splits an XPath expression. Each expression can consists of
|
|
* list of steps being separated from each other by a / character.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $expression The complete expression to be splitted
|
|
* into its different steps.
|
|
* @return array The array returned from this method contains a list
|
|
* of all steps found in the expression passed to this
|
|
* method as a parameter.
|
|
* @see evalute()
|
|
*/
|
|
function split_steps ( $expression )
|
|
{
|
|
// Create an empty array.
|
|
$steps = array();
|
|
|
|
// Replace a double slashes, because they'll cause problems otherwise.
|
|
$expression = str_replace("//@", "/descendant::*/@", $expression);
|
|
$expression = str_replace("//", "/descendant::", $expression);
|
|
|
|
// Save the position of the slash.
|
|
$position = -1;
|
|
|
|
// Run through the expression.
|
|
do
|
|
{
|
|
// Search for a slash.
|
|
$position = $this->search_string($expression, "/");
|
|
|
|
// Check whether a slash was found.
|
|
if ( $position >= 0 )
|
|
{
|
|
// Get the left part of the expression.
|
|
$left = substr($expression, 0, $position);
|
|
$right = substr($expression, $position + 1);
|
|
|
|
// Add the left value to the steps.
|
|
$steps[] = $left;
|
|
|
|
// Reduce the expression to the right part.
|
|
$expression = $right;
|
|
}
|
|
}
|
|
while ( $position > -1 );
|
|
|
|
// Add the remaing expression to the list of steps.
|
|
$steps[] = $expression;
|
|
|
|
// Return the steps.
|
|
return $steps;
|
|
}
|
|
|
|
/**
|
|
* Retrieves axis information from an XPath expression step.
|
|
*
|
|
* This method tries to extract the name of the axis and its node-test
|
|
* from a given step of an XPath expression at a given node.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $step String containing a step of an XPath expression.
|
|
* @param string $node Full document path of the node on which the
|
|
* step is executed.
|
|
* @return array This method returns an array containing information
|
|
* about the axis found in the step.
|
|
* @see evaluate_step()
|
|
*/
|
|
function get_axis ( $step, $node )
|
|
{
|
|
// Create an array to save the axis information.
|
|
$axis = array(
|
|
"axis" => "",
|
|
"node-test" => "",
|
|
"predicate" => array()
|
|
);
|
|
|
|
// Check whether there are predicates.
|
|
if ( ereg("\[", $step) )
|
|
{
|
|
// Get the predicates.
|
|
$predicates = substr($step, strpos($step, "["));
|
|
|
|
// Reduce the step.
|
|
$step = $this->prestr($step, "[");
|
|
|
|
// Try to split the predicates.
|
|
$predicates = str_replace("][", "]|[", $predicates);
|
|
$predicates = explode("|", $predicates);
|
|
|
|
// Run through all predicates.
|
|
foreach ( $predicates as $predicate )
|
|
{
|
|
// Remove the brackets.
|
|
$predicate = substr($predicate, 1, strlen($predicate) - 2);
|
|
|
|
// Add the predicate to the list of predicates.
|
|
$axis["predicate"][] = $predicate;
|
|
}
|
|
}
|
|
|
|
// Check whether the axis is given in plain text.
|
|
if ( $this->search_string($step, "::") > -1 )
|
|
{
|
|
// Split the step to extract axis and node-test.
|
|
$axis["axis"] = $this->prestr($step, "::");
|
|
$axis["node-test"] = $this->afterstr($step, "::");
|
|
}
|
|
else
|
|
{
|
|
// Check whether the step is empty.
|
|
if ( empty($step) )
|
|
{
|
|
// Set it to the default value.
|
|
$step = ".";
|
|
}
|
|
|
|
// Check whether is an abbreviated syntax.
|
|
if ( $step == "*" )
|
|
{
|
|
// Use the child axis and select all children.
|
|
$axis["axis"] = "child";
|
|
$axis["node-test"] = "*";
|
|
}
|
|
elseif ( ereg("\(", $step) )
|
|
{
|
|
// Check whether it's a function.
|
|
if ( $this->is_function($this->prestr($step, "(")) )
|
|
{
|
|
// Get the position of the first bracket.
|
|
$start = strpos($step, "(");
|
|
$end = strpos($step, ")", $start);
|
|
|
|
// Get everything before, between and after the brackets.
|
|
$before = substr($step, 0, $start);
|
|
$between = substr($step, $start + 1, $end - $start - 1);
|
|
$after = substr($step, $end + 1);
|
|
|
|
// Trim each string.
|
|
$before = trim($before);
|
|
$between = trim($between);
|
|
$after = trim($after);
|
|
|
|
// Save the evaluated function.
|
|
$axis["axis"] = "function";
|
|
$axis["node-test"] = $this->evaluate_function($before,
|
|
$between, $node);
|
|
}
|
|
else
|
|
{
|
|
// Use the child axis and a function.
|
|
$axis["axis"] = "child";
|
|
$axis["node-test"] = $step;
|
|
}
|
|
}
|
|
elseif ( eregi("^@", $step) )
|
|
{
|
|
// Use the attribute axis and select the attribute.
|
|
$axis["axis"] = "attribute";
|
|
$axis["node-test"] = substr($step, 1);
|
|
}
|
|
elseif ( eregi("\]$", $step) )
|
|
{
|
|
// Use the child axis and select a position.
|
|
$axis["axis"] = "child";
|
|
$axis["node-test"] = substr($step, strpos($step, "["));
|
|
}
|
|
elseif ( $step == "." )
|
|
{
|
|
// Select the self axis.
|
|
$axis["axis"] = "self";
|
|
$axis["node-test"] = "*";
|
|
}
|
|
elseif ( $step == ".." )
|
|
{
|
|
// Select the parent axis.
|
|
$axis["axis"] = "parent";
|
|
$axis["node-test"] = "*";
|
|
}
|
|
elseif ( ereg("^[a-zA-Z0-9\-_]+$", $step) )
|
|
{
|
|
// Select the child axis and the child.
|
|
$axis["axis"] = "child";
|
|
$axis["node-test"] = $step;
|
|
}
|
|
else
|
|
{
|
|
// Use the child axis and a name.
|
|
$axis["axis"] = "child";
|
|
$axis["node-test"] = $step;
|
|
}
|
|
}
|
|
|
|
// Check whether it's a valid axis.
|
|
if ( !in_array($axis["axis"], array_merge($this->axes,
|
|
array("function"))) )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath expression, in ".
|
|
"the step \"%s\" the invalid axis \"%s\" was found.",
|
|
str_replace($step, "<b>".$step."</b>", $this->xpath),#
|
|
$axis["axis"]);
|
|
}
|
|
|
|
// Return the axis information.
|
|
return $axis;
|
|
}
|
|
|
|
/**
|
|
* Looks for a string within another string.
|
|
*
|
|
* This method looks for a string within another string. Brackets in the
|
|
* string the method is looking through will be respected, which means that
|
|
* only if the string the method is looking for is located outside of
|
|
* brackets, the search will be successful.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $term String in which the search shall take place.
|
|
* @param string $expression String that should be searched.
|
|
* @return int This method returns -1 if no string was found, otherwise
|
|
* the offset at which the string was found.
|
|
* @see evaluate_step()
|
|
*/
|
|
function search_string ( $term, $expression )
|
|
{
|
|
// Create a new counter for the brackets.
|
|
$brackets = 0;
|
|
|
|
// Run through the string.
|
|
for ( $i = 0; $i < strlen($term); $i++ )
|
|
{
|
|
// Get the character at the position of the string.
|
|
$character = substr($term, $i, 1);
|
|
|
|
// Check whether it's a breacket.
|
|
if ( ( $character == "(" ) || ( $character == "[" ) )
|
|
{
|
|
// Increase the number of brackets.
|
|
$brackets++;
|
|
}
|
|
elseif ( ( $character == ")" ) || ( $character == "]" ) )
|
|
{
|
|
// Decrease the number of brackets.
|
|
$brackets--;
|
|
}
|
|
elseif ( $brackets == 0 )
|
|
{
|
|
// Check whether we can find the expression at this index.
|
|
if ( substr($term, $i, strlen($expression)) == $expression )
|
|
{
|
|
// Return the current index.
|
|
return $i;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether we had a valid number of brackets.
|
|
if ( $brackets != 0 )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath expression, in the ".
|
|
"predicate \"%s\", there was an invalid number of brackets.",
|
|
str_replace($term, "<b>".$term."</b>", $this->xpath));
|
|
}
|
|
|
|
// Nothing was found.
|
|
return (-1);
|
|
}
|
|
|
|
/**
|
|
* Checks for a valid function name.
|
|
*
|
|
* This method check whether an expression contains a valid name of an
|
|
* XPath function.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $expression Name of the function to be checked.
|
|
* @return boolean This method returns true if the given name is a valid
|
|
* XPath function name, otherwise false.
|
|
* @see evaluate()
|
|
*/
|
|
function is_function ( $expression )
|
|
{
|
|
// Check whether it's in the list of supported functions.
|
|
if ( in_array($expression, $this->functions) )
|
|
{
|
|
// It's a function.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// It's not a function.
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Evaluates a step of an XPath expression.
|
|
*
|
|
* This method tries to evaluate a step from an XPath expression at a
|
|
* specific context.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $context Full document path of the context from
|
|
* which starting the step should be evaluated.
|
|
* @param array $steps Array containing the remaining steps of the
|
|
* current XPath expression.
|
|
* @return array This method returns an array containing all nodes
|
|
* that are the result of evaluating the given XPath step.
|
|
* @see evaluate()
|
|
*/
|
|
function evaluate_step ( $context, $steps )
|
|
{
|
|
// Create an empty array for saving the nodes found.
|
|
$nodes = array();
|
|
|
|
// Check whether the context is an array of contexts.
|
|
if ( is_array($context) )
|
|
{
|
|
// Run through the array.
|
|
foreach ( $context as $path )
|
|
{
|
|
// Call this method for this single path.
|
|
$nodes = array_merge($nodes,
|
|
$this->evaluate_step($path, $steps));
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Get this step.
|
|
$step = array_shift($steps);
|
|
|
|
// Create an array to save the new contexts.
|
|
$contexts = array();
|
|
|
|
// Get the axis of the current step.
|
|
$axis = $this->get_axis($step, $context);
|
|
|
|
// Check whether it's a function.
|
|
if ( $axis["axis"] == "function" )
|
|
{
|
|
// Check whether an array was return by the function.
|
|
if ( is_array($axis["node-test"]) )
|
|
{
|
|
// Add the results to the list of contexts.
|
|
$contexts = array_merge($contexts, $axis["node-test"]);
|
|
}
|
|
else
|
|
{
|
|
// Add the result to the list of contexts.
|
|
$contexts[] = $axis["node-test"];
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Create the name of the method.
|
|
$method = "handle_axis_".str_replace("-", "_", $axis["axis"]);
|
|
|
|
// Check whether the axis handler is defined.
|
|
if ( !method_exists(&$this, $method) )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath expression, ".
|
|
"the axis \"%s\" could not be handled, because this ".
|
|
"version does not support this axis.", $axis["axis"]);
|
|
}
|
|
|
|
// Perform an axis action.
|
|
$contexts = call_user_method($method, &$this, $axis, $context);
|
|
|
|
// Check whether there are predicates.
|
|
if ( count($axis["predicate"]) > 0 )
|
|
{
|
|
// Check whether each node fits the predicates.
|
|
$contexts = $this->check_predicates($contexts,
|
|
$axis["predicate"]);
|
|
}
|
|
}
|
|
|
|
// Check whether there are more steps left.
|
|
if ( count($steps) > 0 )
|
|
{
|
|
// Continue the evaluation of the next steps.
|
|
$nodes = $this->evaluate_step($contexts, $steps);
|
|
}
|
|
else
|
|
{
|
|
// Save the found contexts.
|
|
$nodes = $contexts;
|
|
}
|
|
}
|
|
|
|
// Return the nodes found.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Evaluates an XPath function
|
|
*
|
|
* This method evaluates a given XPath function with its arguments on a
|
|
* specific node of the document.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $function Name of the function to be evaluated.
|
|
* @param string $arguments String containing the arguments being
|
|
* passed to the function.
|
|
* @param string $node Full path to the document node on which the
|
|
* function should be evaluated.
|
|
* @return mixed This method returns the result of the evaluation of
|
|
* the function. Depending on the function the type of the
|
|
* return value can be different.
|
|
* @see evaluate()
|
|
*/
|
|
function evaluate_function ( $function, $arguments, $node )
|
|
{
|
|
// Remove whitespaces.
|
|
$function = trim($function);
|
|
$arguments = trim($arguments);
|
|
|
|
// Create the name of the function handling function.
|
|
$method = "handle_function_".str_replace("-", "_", $function);
|
|
|
|
// Check whether the function handling function is available.
|
|
if ( !method_exists(&$this, $method) )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath expression, ".
|
|
"the function \"%s\" could not be handled, because this ".
|
|
"version does not support this function.", $function);
|
|
}
|
|
|
|
// Return the result of the function.
|
|
return call_user_method($method, &$this, $node, $arguments);
|
|
}
|
|
|
|
/**
|
|
* Evaluates a predicate on a node.
|
|
*
|
|
* This method tries to evaluate a predicate on a given node.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the predicate
|
|
* should be evaluated.
|
|
* @param string $predicate String containing the predicate expression
|
|
* to be evaluated.
|
|
* @return mixed This method is called recursively. The first call should
|
|
* return a boolean value, whether the node matches the predicate
|
|
* or not. Any call to the method being made during the recursion
|
|
* may also return other types for further processing.
|
|
* @see evaluate()
|
|
*/
|
|
function evaluate_predicate ( $node, $predicate )
|
|
{
|
|
// Set the default position and the type of the operator.
|
|
$position = 0;
|
|
$operator = "";
|
|
|
|
// Run through all operators and try to find them.
|
|
foreach ( $this->operators as $expression )
|
|
{
|
|
// Check whether a position was already found.
|
|
if ( $position <= 0 )
|
|
{
|
|
// Try to find the operator.
|
|
$position = $this->search_string($predicate, $expression);
|
|
|
|
// Check whether a operator was found.
|
|
if ( $position > 0 )
|
|
{
|
|
// Save the operator.
|
|
$operator = $expression;
|
|
|
|
// Check whether it's the equal operator.
|
|
if ( $operator == "=" )
|
|
{
|
|
// Also look for other operators containing the
|
|
// equal sign.
|
|
if ( $this->search_string($predicate, "!=") ==
|
|
( $position - 1 ) )
|
|
{
|
|
// Get the new position.
|
|
$position = $this->search_string($predicate, "!=");
|
|
|
|
// Save the new operator.
|
|
$operator = "!=";
|
|
}
|
|
if ( $this->search_string($predicate, "<=") ==
|
|
( $position - 1 ) )
|
|
{
|
|
// Get the new position.
|
|
$position = $this->search_string($predicate, "<=");
|
|
|
|
// Save the new operator.
|
|
$operator = "<=";
|
|
}
|
|
if ( $this->search_string($predicate, ">=") ==
|
|
( $position - 1 ) )
|
|
{
|
|
// Get the new position.
|
|
$position = $this->search_string($predicate, ">=");
|
|
|
|
// Save the new operator.
|
|
$operator = ">=";
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether the operator is a - sign.
|
|
if ( $operator == "-" )
|
|
{
|
|
// Check whether it's not a function containing a - in its name.
|
|
foreach ( $this->functions as $function )
|
|
{
|
|
// Check whether there's a - sign in the function name.
|
|
if ( ereg("-", $function) )
|
|
{
|
|
// Get the position of the - in the function name.
|
|
$sign = strpos($function, "-");
|
|
|
|
// Extract a substring from the predicate.
|
|
$sub = substr($predicate, $position - $sign,
|
|
strlen($function));
|
|
|
|
// Check whether it's the function.
|
|
if ( $sub == $function )
|
|
{
|
|
// Don't use the operator.
|
|
$operator = "";
|
|
$position = -1;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
elseif ( $operator == "*" )
|
|
{
|
|
// Get some substrings.
|
|
$character = substr($predicate, $position - 1, 1);
|
|
$attribute = substr($predicate, $position - 11, 11);
|
|
|
|
// Check whether it's an attribute selection.
|
|
if ( ( $character == "@" ) || ( $attribute == "attribute::" ) )
|
|
{
|
|
// Don't use the operator.
|
|
$operator = "";
|
|
$position = -1;
|
|
}
|
|
}
|
|
|
|
// Check whether an operator was found.
|
|
if ( $position > 0 )
|
|
{
|
|
// Get the left and the right part of the expression.
|
|
$left = substr($predicate, 0, $position);
|
|
$right = substr($predicate, $position + strlen($operator));
|
|
|
|
// Remove whitespaces.
|
|
$left = trim($left);
|
|
$right = trim($right);
|
|
|
|
// Evaluate the left and the right part.
|
|
$left = $this->evaluate_predicate($node, $left);
|
|
$right = $this->evaluate_predicate($node, $right);
|
|
|
|
// Check the kind of operator.
|
|
switch ( $operator )
|
|
{
|
|
case " or ":
|
|
// Return the two results connected by an "or".
|
|
return ( $left or $right );
|
|
|
|
case " and ":
|
|
// Return the two results connected by an "and".
|
|
return ( $left and $right );
|
|
|
|
case "=":
|
|
// Compare the two results.
|
|
return ( $left == $right );
|
|
|
|
case "!=":
|
|
// Check whether the two results are not equal.
|
|
return ( $left != $right );
|
|
|
|
case "<=":
|
|
// Compare the two results.
|
|
return ( $left <= $right );
|
|
|
|
case "<":
|
|
// Compare the two results.
|
|
return ( $left < $right );
|
|
|
|
case ">=":
|
|
// Compare the two results.
|
|
return ( $left >= $right );
|
|
|
|
case ">":
|
|
// Compare the two results.
|
|
return ( $left > $right );
|
|
|
|
case "+":
|
|
// Return the result by adding one result to the other.
|
|
return ( $left + $right );
|
|
|
|
case "-":
|
|
// Return the result by decrease one result by the other.
|
|
return ( $left - $right );
|
|
|
|
case "*":
|
|
// Return a multiplication of the two results.
|
|
return ( $left * $right );
|
|
|
|
case " div ":
|
|
// Return a division of the two results.
|
|
if ( $right == 0 )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath ".
|
|
"predicate, a error due a division by zero ".
|
|
"occured.");
|
|
}
|
|
else
|
|
{
|
|
// Return the result of the division.
|
|
return ( $left / $right );
|
|
}
|
|
break;
|
|
|
|
case " mod ":
|
|
// Return a modulo of the two results.
|
|
return ( $left % $right );
|
|
}
|
|
}
|
|
|
|
// Check whether the predicate is a function.
|
|
if ( ereg("\(", $predicate) )
|
|
{
|
|
// Get the position of the first bracket.
|
|
$start = strpos($predicate, "(");
|
|
$end = strpos($predicate, ")", $start);
|
|
|
|
// Get everything before, between and after the brackets.
|
|
$before = substr($predicate, 0, $start);
|
|
$between = substr($predicate, $start + 1, $end - $start - 1);
|
|
$after = substr($predicate, $end + 1);
|
|
|
|
// Trim each string.
|
|
$before = trim($before);
|
|
$between = trim($between);
|
|
$after = trim($after);
|
|
|
|
// Check whether there's something after the bracket.
|
|
if ( !empty($after) )
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath expression ".
|
|
"there was found an error in the predicate \"%s\", ".
|
|
"because after a closing bracket there was found ".
|
|
"something unknown.", str_replace($predicate,
|
|
"<b>".$predicate."</b>", $this->xpath));
|
|
}
|
|
|
|
// Check whether it's a function.
|
|
if ( empty($before) && empty($after) )
|
|
{
|
|
// Evaluate the content of the brackets.
|
|
return $this->evaluate_predicate($node, $between);
|
|
}
|
|
elseif ( $this->is_function($before) )
|
|
{
|
|
// Return the evaluated function.
|
|
return $this->evaluate_function($before, $between, $node);
|
|
}
|
|
else
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing a predicate in an XPath ".
|
|
"expression, a function \"%s\" was found, which is not ".
|
|
"yet supported by the parser.", str_replace($before,
|
|
"<b>".$before."</b>", $this->xpath));
|
|
}
|
|
}
|
|
|
|
// Check whether the predicate is just a digit.
|
|
if ( ereg("^[0-9]+(\.[0-9]+)?$", $predicate) ||
|
|
ereg("^\.[0-9]+$", $predicate) )
|
|
{
|
|
// Return the value of the digit.
|
|
return doubleval($predicate);
|
|
}
|
|
|
|
// Check whether it's an XPath expression.
|
|
$result = $this->evaluate($predicate, $node);
|
|
if ( count($result) > 0 )
|
|
{
|
|
// Convert the array.
|
|
$result = explode("|", implode("|", $result));
|
|
|
|
// Get the value of the first result.
|
|
$value = $this->get_content($result[0]);
|
|
|
|
// Return the value.
|
|
return $value;
|
|
}
|
|
|
|
// Return the predicate as a string.
|
|
return $predicate;
|
|
}
|
|
|
|
/**
|
|
* Checks whether a node matches predicates.
|
|
*
|
|
* This method checks whether a list of nodes passed to this method match
|
|
* a given list of predicates.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $nodes Array of full paths of all nodes to be tested.
|
|
* @param array $predicates Array of predicates to use.
|
|
* @return array The array returned by this method contains a list of
|
|
* all nodes matching the given predicates.
|
|
* @see evaluate_step()
|
|
*/
|
|
function check_predicates ( $nodes, $predicates )
|
|
{
|
|
// Create an empty set of nodes.
|
|
$result = array();
|
|
|
|
// Run through all nodes.
|
|
foreach ( $nodes as $node )
|
|
{
|
|
// Create a variable whether to add this node to the node-set.
|
|
$add = true;
|
|
|
|
// Run through all predicates.
|
|
foreach ( $predicates as $predicate )
|
|
{
|
|
// Check whether the predicate is just an number.
|
|
if ( ereg("^[0-9]+$", $predicate) )
|
|
{
|
|
// Enhance the predicate.
|
|
$predicate .= "=position()";
|
|
}
|
|
|
|
// Do the predicate check.
|
|
$check = $this->evaluate_predicate($node, $predicate);
|
|
|
|
// Check whether it's a string.
|
|
if ( is_string($check) && ( ( $check == "" ) ||
|
|
( $check == $predicate ) ) )
|
|
{
|
|
// Set the result to false.
|
|
$check = false;
|
|
}
|
|
|
|
// Check whether it's an integer.
|
|
if ( is_int($check) )
|
|
{
|
|
// Check whether it's the current position.
|
|
if ( $check == $this->handle_function_position($node, "") )
|
|
{
|
|
// Set it to true.
|
|
$check = true;
|
|
}
|
|
else
|
|
{
|
|
// Set it to false.
|
|
$check = false;
|
|
}
|
|
}
|
|
|
|
// Check whether the predicate is OK for this node.
|
|
$add = $add && $check;
|
|
}
|
|
|
|
// Check whether to add this node to the node-set.
|
|
if ( $add )
|
|
{
|
|
// Add the node to the node-set.
|
|
$result[] = $node;
|
|
}
|
|
}
|
|
|
|
// Return the array of nodes.
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* Checks whether a node matches a node-test.
|
|
*
|
|
* This method checks whether a node in the document matches a given
|
|
* node-test.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $context Full path of the node, which should be tested
|
|
* for matching the node-test.
|
|
* @param string $node_test String containing the node-test for the
|
|
* node.
|
|
* @return boolean This method returns true if the node matches the
|
|
* node-test, otherwise false.
|
|
* @see evaluate()
|
|
*/
|
|
function check_node_test ( $context, $node_test )
|
|
{
|
|
// Check whether it's a function.
|
|
if ( ereg("\(", $node_test) )
|
|
{
|
|
// Get the type of function to use.
|
|
$function = $this->prestr($node_test, "(");
|
|
|
|
// Check whether the node fits the method.
|
|
switch ( $function )
|
|
{
|
|
case "node":
|
|
// Add this node to the list of nodes.
|
|
return true;
|
|
|
|
case "text":
|
|
// Check whether the node has some text.
|
|
if ( !empty($this->nodes[$context]["text"]) )
|
|
{
|
|
// Add this node to the list of nodes.
|
|
return true;
|
|
}
|
|
break;
|
|
|
|
case "comment":
|
|
// Check whether the node has some comment.
|
|
if ( !empty($this->nodes[$context]["comment"]) )
|
|
{
|
|
// Add this node to the list of nodes.
|
|
return true;
|
|
}
|
|
break;
|
|
|
|
case "processing-instruction":
|
|
// Get the literal argument.
|
|
$literal = $this->afterstr($axis["node-test"], "(");
|
|
|
|
// Cut the literal.
|
|
$literal = substr($literal, 0, strlen($literal) - 1);
|
|
|
|
// Check whether a literal was given.
|
|
if ( !empty($literal) )
|
|
{
|
|
// Check whether the node's processing instructions
|
|
// are matching the literals given.
|
|
if ( $this->nodes[$context]
|
|
["processing-instructions"] == $literal )
|
|
{
|
|
// Add this node to the node-set.
|
|
return true;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Check whether the node has processing
|
|
// instructions.
|
|
if ( !empty($this->nodes[$context]
|
|
["processing-instructions"]) )
|
|
{
|
|
// Add this node to the node-set.
|
|
return true;
|
|
}
|
|
}
|
|
break;
|
|
|
|
default:
|
|
// Display an error message.
|
|
$this->display_error("While parsing an XPath ".
|
|
"expression there was found an undefined ".
|
|
"function called \"%s\".",
|
|
str_replace($function, "<b>".$function."</b>",
|
|
$this->xpath));
|
|
}
|
|
}
|
|
elseif ( $node_test == "*" )
|
|
{
|
|
// Add this node to the node-set.
|
|
return true;
|
|
}
|
|
elseif ( ereg("^[a-zA-Z0-9\-_]+", $node_test) )
|
|
{
|
|
// Check whether the node-test can be fulfilled.
|
|
if ( $this->nodes[$context]["name"] == $node_test )
|
|
{
|
|
// Add this node to the node-set.
|
|
return true;
|
|
}
|
|
}
|
|
else
|
|
{
|
|
// Display an error message.
|
|
$this->display_error("While parsing the XPath expression \"%s\" ".
|
|
"an empty and therefore invalid node-test has been found.",
|
|
$this->xpath);
|
|
}
|
|
|
|
// Don't add this context.
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath child axis.
|
|
*
|
|
* This method handles the XPath child axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_child ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get a list of all children.
|
|
$children = $this->nodes[$context]["children"];
|
|
|
|
// Check whether there are children.
|
|
if ( !empty($children) )
|
|
{
|
|
// Run through all children.
|
|
foreach ( $children as $child_name => $child_position )
|
|
{
|
|
// Run through all childs with this name.
|
|
for ( $i = 1; $i <= $child_position; $i++ )
|
|
{
|
|
// Create the path of the child.
|
|
$child = $context."/".$child_name."[".$i."]";
|
|
|
|
// Check whether
|
|
if ( $this->check_node_test($child, $axis["node-test"]) )
|
|
{
|
|
// Add the child to the node-set.
|
|
$nodes[] = $child;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath parent axis.
|
|
*
|
|
* This method handles the XPath parent axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_parent ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Check whether the parent matches the node-test.
|
|
if ( $this->check_node_test($this->nodes[$context]["parent"],
|
|
$axis["node-test"]) )
|
|
{
|
|
// Add this node to the list of nodes.
|
|
$nodes[] = $this->nodes[$context]["parent"];
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath attribute axis.
|
|
*
|
|
* This method handles the XPath attribute axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_attribute ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Check whether all nodes should be selected.
|
|
if ( $axis["node-test"] == "*" )
|
|
{
|
|
// Check whether there are attributes.
|
|
if ( count($this->nodes[$context]["attributes"]) > 0 )
|
|
{
|
|
// Run through the attributes.
|
|
foreach ( $this->nodes[$context]["attributes"] as
|
|
$key => $value )
|
|
{
|
|
// Add this node to the node-set.
|
|
$nodes[] = $context."/attribute::".$key;
|
|
}
|
|
}
|
|
}
|
|
elseif ( !empty($this->nodes[$context]["attributes"]
|
|
[$axis["node-test"]]) )
|
|
{
|
|
// Add this node to the node-set.
|
|
$nodes[] = $context."/attribute::".$axis["node-test"];
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath self axis.
|
|
*
|
|
* This method handles the XPath self axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_self ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Check whether the context match the node-test.
|
|
if ( $this->check_node_test($context, $axis["node-test"]) )
|
|
{
|
|
// Add this node to the node-set.
|
|
$nodes[] = $context;
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath descendant axis.
|
|
*
|
|
* This method handles the XPath descendant axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_descendant ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Check whether the current node has children.
|
|
if ( count($this->nodes[$context]["children"]) > 0 )
|
|
{
|
|
// Get a list of children.
|
|
$children = $this->nodes[$context]["children"];
|
|
|
|
// Run through all children.
|
|
foreach ( $children as $child_name => $child_position )
|
|
{
|
|
// Run through all children of this name.
|
|
for ( $i = 1; $i <= $child_position; $i++ )
|
|
{
|
|
// Create the full path for the children.
|
|
$child = $context."/".$child_name."[".$i."]";
|
|
|
|
// Check whether the child matches the node-test.
|
|
if ( $this->check_node_test($child, $axis["node-test"]) )
|
|
{
|
|
// Add the child to the list of nodes.
|
|
$nodes[] = $child;
|
|
}
|
|
|
|
// Recurse to the next level.
|
|
$nodes = array_merge($nodes,
|
|
$this->handle_axis_descendant($axis, $child));
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath ancestor axis.
|
|
*
|
|
* This method handles the XPath ancestor axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_ancestor ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get the parent of the current node.
|
|
$parent = $this->nodes[$context]["parent"];
|
|
|
|
// Check whether the parent isn't empty.
|
|
if ( !empty($parent) )
|
|
{
|
|
// Check whether the parent matches the node-test.
|
|
if ( $this->check_node_test($parent, $axis["node-test"]) )
|
|
{
|
|
// Add the parent to the list of nodes.
|
|
$nodes[] = $parent;
|
|
}
|
|
|
|
// Handle all other ancestors.
|
|
$nodes = array_merge($nodes,
|
|
$this->handle_axis_ancestor($axis, $parent));
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath namespace axis.
|
|
*
|
|
* This method handles the XPath namespace axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_namespace ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Check whether all nodes should be selected.
|
|
if ( !empty($this->nodes[$context]["namespace"]) )
|
|
{
|
|
// Add this node to the node-set.
|
|
$nodes[] = $context;
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath following axis.
|
|
*
|
|
* This method handles the XPath following axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_following ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get the current document position.
|
|
$position = $this->nodes[$context]["document-position"];
|
|
|
|
// Create a flag, whether we already found the context node.
|
|
$found = false;
|
|
|
|
// Run through all nodes of the document.
|
|
foreach ( $this->nodes as $node => $data )
|
|
{
|
|
// Check whether the context node has already been found.
|
|
if ( $found )
|
|
{
|
|
// Check whether the position is correct.
|
|
if ( $this->nodes[$node]["document-position"] == $position )
|
|
{
|
|
// Check whether the node fits the node-test.
|
|
if ( $this->check_node_test($node, $axis["node-test"]) )
|
|
{
|
|
// Add the node to the list of nodes.
|
|
$nodes[] = $node;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether this is the context node.
|
|
if ( $node == $context )
|
|
{
|
|
// After this we'll look for more nodes.
|
|
$found = true;
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath preceding axis.
|
|
*
|
|
* This method handles the XPath preceding axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_preceding ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get the current document position.
|
|
$position = $this->nodes[$context]["document-position"];
|
|
|
|
// Create a flag, whether we already found the context node.
|
|
$found = true;
|
|
|
|
// Run through all nodes of the document.
|
|
foreach ( $this->nodes as $node => $data )
|
|
{
|
|
// Check whether this is the context node.
|
|
if ( $node == $context )
|
|
{
|
|
// After this we won't look for more nodes.
|
|
$found = false;
|
|
}
|
|
|
|
// Check whether the context node has already been found.
|
|
if ( $found )
|
|
{
|
|
// Check whether the position is correct.
|
|
if ( $this->nodes[$node]["document-position"] == $position )
|
|
{
|
|
// Check whether the node fits the node-test.
|
|
if ( $this->check_node_test($node, $axis["node-test"]) )
|
|
{
|
|
// Add the node to the list of nodes.
|
|
$nodes[] = $node;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath following-sibling axis.
|
|
*
|
|
* This method handles the XPath following-sibling axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_following_sibling ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get all children from the parent.
|
|
$siblings = $this->handle_axis_child($axis,
|
|
$this->nodes[$context]["parent"]);
|
|
|
|
// Create a flag whether the context node was already found.
|
|
$found = false;
|
|
|
|
// Run through all siblings.
|
|
foreach ( $siblings as $sibling )
|
|
{
|
|
// Check whether the context node was already found.
|
|
if ( $found )
|
|
{
|
|
// Check whether the sibling is a real sibling.
|
|
if ( $this->nodes[$sibling]["name"] ==
|
|
$this->nodes[$context]["name"] )
|
|
{
|
|
// Check whether the sibling matches the node-test.
|
|
if ( $this->check_node_test($sibling, $axis["node-test"]) )
|
|
{
|
|
// Add the sibling to the list of nodes.
|
|
$nodes[] = $sibling;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Check whether this is the context node.
|
|
if ( $sibling == $context )
|
|
{
|
|
// Continue looking for other siblings.
|
|
$found = true;
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath preceding-sibling axis.
|
|
*
|
|
* This method handles the XPath preceding-sibling axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_preceding_sibling ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Get all children from the parent.
|
|
$siblings = $this->handle_axis_child($axis,
|
|
$this->nodes[$context]["parent"]);
|
|
|
|
// Create a flag whether the context node was already found.
|
|
$found = true;
|
|
|
|
// Run through all siblings.
|
|
foreach ( $siblings as $sibling )
|
|
{
|
|
// Check whether this is the context node.
|
|
if ( $sibling == $context )
|
|
{
|
|
// Don't continue looking for other siblings.
|
|
$found = false;
|
|
}
|
|
|
|
// Check whether the context node was already found.
|
|
if ( $found )
|
|
{
|
|
// Check whether the sibling is a real sibling.
|
|
if ( $this->nodes[$sibling]["name"] ==
|
|
$this->nodes[$context]["name"] )
|
|
{
|
|
// Check whether the sibling matches the node-test.
|
|
if ( $this->check_node_test($sibling, $axis["node-test"]) )
|
|
{
|
|
// Add the sibling to the list of nodes.
|
|
$nodes[] = $sibling;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath descendant-or-self axis.
|
|
*
|
|
* This method handles the XPath descendant-or-self axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_descendant_or_self ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Read the nodes.
|
|
$nodes = array_merge(
|
|
$this->handle_axis_descendant($axis, $context),
|
|
$this->handle_axis_self($axis, $context));
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath ancestor-or-self axis.
|
|
*
|
|
* This method handles the XPath ancestor-or-self axis.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param array $axis Array containing information about the axis.
|
|
* @param string $context Node from which starting the axis should
|
|
* be processed.
|
|
* @return array This method returns an array containing all nodes
|
|
* that were found during the evaluation of the given axis.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_axis_ancestor_or_self ( $axis, $context )
|
|
{
|
|
// Create an empty node-set.
|
|
$nodes = array();
|
|
|
|
// Read the nodes.
|
|
$nodes = array_merge(
|
|
$this->handle_axis_ancestor($axis, $context),
|
|
$this->handle_axis_self($axis, $context));
|
|
|
|
// Return the nodeset.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function last.
|
|
*
|
|
* This method handles the XPath function last.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_last ( $node, $arguments )
|
|
{
|
|
// Calculate the size of the context.
|
|
$parent = $this->nodes[$node]["parent"];
|
|
$children = $this->nodes[$parent]["children"];
|
|
$context = $children[$this->nodes[$node]["name"]];
|
|
|
|
// Return the size.
|
|
return $context;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function position.
|
|
*
|
|
* This method handles the XPath function position.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_position ( $node, $arguments )
|
|
{
|
|
// return the context-position.
|
|
return $this->nodes[$node]["context-position"];
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function count.
|
|
*
|
|
* This method handles the XPath function count.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_count ( $node, $arguments )
|
|
{
|
|
// Evaluate the argument of the method as an XPath and return
|
|
// the number of results.
|
|
return count($this->evaluate($arguments, $node));
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function id.
|
|
*
|
|
* This method handles the XPath function id.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_id ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Now split the arguments.
|
|
$arguments = explode(" ", $arguments);
|
|
|
|
// Check whether
|
|
|
|
// Create a list of nodes.
|
|
$nodes = array();
|
|
|
|
// Run through all document node.
|
|
foreach ( $this->nodes as $node => $position )
|
|
{
|
|
// Check whether the node has the ID we're looking for.
|
|
if ( in_array($this->nodes[$node]["attributes"]["id"],
|
|
$arguments) )
|
|
{
|
|
// Add this node to the list of nodes.
|
|
$nodes[] = $node;
|
|
}
|
|
}
|
|
|
|
// Return the list of nodes.
|
|
return $nodes;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function name.
|
|
*
|
|
* This method handles the XPath function name.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_name ( $node, $arguments )
|
|
{
|
|
// Return the name of the node.
|
|
return $this->nodes[$node]["name"];
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function string.
|
|
*
|
|
* This method handles the XPath function string.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_string ( $node, $arguments )
|
|
{
|
|
// Check what type of parameter is given
|
|
if ( ereg("^[0-9]+(\.[0-9]+)?$", $arguments) ||
|
|
ereg("^\.[0-9]+$", $arguments) )
|
|
{
|
|
// Convert the digits to a number.
|
|
$number = doubleval($arguments);
|
|
|
|
// Return the number.
|
|
return strval($number);
|
|
}
|
|
elseif ( is_bool($arguments) )
|
|
{
|
|
// Check whether it's true.
|
|
if ( $arguments == true )
|
|
{
|
|
// Return true as a string.
|
|
return "true";
|
|
}
|
|
else
|
|
{
|
|
// Return false as a string.
|
|
return "false";
|
|
}
|
|
}
|
|
elseif ( !empty($arguments) )
|
|
{
|
|
// Use the argument as an XPath.
|
|
$result = $this->evaluate($arguments, $node);
|
|
|
|
// Get the first argument.
|
|
$result = explode("|", implode("|", $result));
|
|
|
|
// Return the first result as a string.
|
|
return $result[0];
|
|
}
|
|
elseif ( empty($arguments) )
|
|
{
|
|
// Return the current node.
|
|
return $node;
|
|
}
|
|
else
|
|
{
|
|
// Return an empty string.
|
|
return "";
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function concat.
|
|
*
|
|
* This method handles the XPath function concat.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_concat ( $node, $arguments )
|
|
{
|
|
// Split the arguments.
|
|
$arguments = explode(",", $arguments);
|
|
|
|
// Run through each argument and evaluate it.
|
|
for ( $i = 0; $i < sizeof($arguments); $i++ )
|
|
{
|
|
// Trim each argument.
|
|
$arguments[$i] = trim($arguments[$i]);
|
|
|
|
// Evaluate it.
|
|
$arguments[$i] = $this->evaluate_predicate($node, $arguments[$i]);
|
|
}
|
|
|
|
// Put the string together.
|
|
$arguments = implode("", $arguments);
|
|
|
|
// Return the string.
|
|
return $arguments;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function starts-with.
|
|
*
|
|
* This method handles the XPath function starts-with.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_starts_with ( $node, $arguments )
|
|
{
|
|
// Get the arguments.
|
|
$first = trim($this->prestr($arguments, ","));
|
|
$second = trim($this->afterstr($arguments, ","));
|
|
|
|
// Evaluate each argument.
|
|
$first = $this->evaluate_predicate($node, $first);
|
|
$second = $this->evaluate_predicate($node, $second);
|
|
|
|
// Check whether the first string starts with the second one.
|
|
if ( ereg("^".$second, $first) )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function contains.
|
|
*
|
|
* This method handles the XPath function contains.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_contains ( $node, $arguments )
|
|
{
|
|
// Get the arguments.
|
|
$first = trim($this->prestr($arguments, ","));
|
|
$second = trim($this->afterstr($arguments, ","));
|
|
|
|
// Evaluate each argument.
|
|
$first = $this->evaluate_predicate($node, $first);
|
|
$second = $this->evaluate_predicate($node, $second);
|
|
|
|
// Check whether the first string starts with the second one.
|
|
if ( ereg($second, $first) )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function substring-before.
|
|
*
|
|
* This method handles the XPath function substring-before.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_substring_before ( $node, $arguments )
|
|
{
|
|
// Get the arguments.
|
|
$first = trim($this->prestr($arguments, ","));
|
|
$second = trim($this->afterstr($arguments, ","));
|
|
|
|
// Evaluate each argument.
|
|
$first = $this->evaluate_predicate($node, $first);
|
|
$second = $this->evaluate_predicate($node, $second);
|
|
|
|
// Return the substring.
|
|
return $this->prestr(strval($first), strval($second));
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function substring-after.
|
|
*
|
|
* This method handles the XPath function substring-after.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_substring_after ( $node, $arguments )
|
|
{
|
|
// Get the arguments.
|
|
$first = trim($this->prestr($arguments, ","));
|
|
$second = trim($this->afterstr($arguments, ","));
|
|
|
|
// Evaluate each argument.
|
|
$first = $this->evaluate_predicate($node, $first);
|
|
$second = $this->evaluate_predicate($node, $second);
|
|
|
|
// Return the substring.
|
|
return $this->afterstr(strval($first), strval($second));
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function substring.
|
|
*
|
|
* This method handles the XPath function substring.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_substring ( $node, $arguments )
|
|
{
|
|
// Split the arguments.
|
|
$arguments = explode(",", $arguments);
|
|
|
|
// Run through all arguments.
|
|
for ( $i = 0; $i < sizeof($arguments); $i++ )
|
|
{
|
|
// Trim the string.
|
|
$arguments[$i] = trim($arguments[$i]);
|
|
|
|
// Evaluate each argument.
|
|
$arguments[$i] = $this->evaluate_predicate($node, $arguments[$i]);
|
|
}
|
|
|
|
// Check whether a third argument was given.
|
|
if ( !empty($arguments[2]) )
|
|
{
|
|
// Return the substring.
|
|
return substr(strval($arguments[0]), $arguments[1] - 1,
|
|
$arguments[2]);
|
|
}
|
|
else
|
|
{
|
|
// Return the substring.
|
|
return substr(strval($arguments[0]), $arguments[1] - 1);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function string-length.
|
|
*
|
|
* This method handles the XPath function string-length.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_string_length ( $node, $arguments )
|
|
{
|
|
// Trim the argument.
|
|
$arguments = trim($arguments);
|
|
|
|
// Evaluate the argument.
|
|
$arguments = $this->evaluate_predicate($node, $arguments);
|
|
|
|
// Return the length of the string.
|
|
return strlen(strval($arguments));
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function translate.
|
|
*
|
|
* This method handles the XPath function translate.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_translate ( $node, $arguments )
|
|
{
|
|
// Split the arguments.
|
|
$arguments = explode(",", $arguments);
|
|
|
|
// Run through all arguments.
|
|
for ( $i = 0; $i < sizeof($arguments); $i++ )
|
|
{
|
|
// Trim the argument.
|
|
$arguments[$i] = trim($arguments[$i]);
|
|
|
|
// Evaluate the argument.
|
|
$arguments[$i] = $this->evaluate_predicate($node, $arguments[$i]);
|
|
}
|
|
|
|
// Return the translated string.
|
|
return strtr($arguments[0], $arguments[1], $arguments[2]);
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function boolean.
|
|
*
|
|
* This method handles the XPath function boolean.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_boolean ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Check what type of parameter is given
|
|
if ( ereg("^[0-9]+(\.[0-9]+)?$", $arguments) ||
|
|
ereg("^\.[0-9]+$", $arguments) )
|
|
{
|
|
// Convert the digits to a number.
|
|
$number = doubleval($arguments);
|
|
|
|
// Check whether the number zero.
|
|
if ( $number == 0 )
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
}
|
|
elseif ( empty($arguments) )
|
|
{
|
|
// Sorry, there were no arguments.
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
// Try to evaluate the argument as an XPath.
|
|
$result = $this->evaluate($arguments, $node);
|
|
|
|
// Check whether we found something.
|
|
if ( count($result) > 0 )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function not.
|
|
*
|
|
* This method handles the XPath function not.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_not ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Return the negative value of the content of the brackets.
|
|
return !$this->evaluate_predicate($node, $arguments);
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function true.
|
|
*
|
|
* This method handles the XPath function true.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_true ( $node, $arguments )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function false.
|
|
*
|
|
* This method handles the XPath function false.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_false ( $node, $arguments )
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function lang.
|
|
*
|
|
* This method handles the XPath function lang.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_lang ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Check whether the node has an language attribute.
|
|
if ( empty($this->nodes[$node]["attributes"]["xml:lang"]) )
|
|
{
|
|
// Run through the ancestors.
|
|
while ( !empty($node) )
|
|
{
|
|
// Select the parent node.
|
|
$node = $this->nodes[$node]["parent"];
|
|
|
|
// Check whether there's a language definition.
|
|
if ( !empty($this->nodes[$node]["attributes"]["xml:lang"]) )
|
|
{
|
|
// Check whether it's the language, the user asks for.
|
|
if ( eregi("^".$arguments, $this->nodes[$node]
|
|
["attributes"]["xml:lang"]) )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Return false.
|
|
return false;
|
|
}
|
|
else
|
|
{
|
|
// Check whether it's the language, the user asks for.
|
|
if ( eregi("^".$arguments, $this->nodes[$node]["attributes"]
|
|
["xml:lang"]) )
|
|
{
|
|
// Return true.
|
|
return true;
|
|
}
|
|
else
|
|
{
|
|
// Return false.
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function number.
|
|
*
|
|
* This method handles the XPath function number.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_number ( $node, $arguments )
|
|
{
|
|
// Check the type of argument.
|
|
if ( ereg("^[0-9]+(\.[0-9]+)?$", $arguments) ||
|
|
ereg("^\.[0-9]+$", $arguments) )
|
|
{
|
|
// Return the argument as a number.
|
|
return doubleval($arguments);
|
|
}
|
|
elseif ( is_bool($arguments) )
|
|
{
|
|
// Check whether it's true.
|
|
if ( $arguments == true )
|
|
{
|
|
// Return 1.
|
|
return 1;
|
|
}
|
|
else
|
|
{
|
|
// Return 0.
|
|
return 0;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function sum.
|
|
*
|
|
* This method handles the XPath function sum.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_sum ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Evaluate the arguments as an XPath expression.
|
|
$results = $this->evaluate($arguments, $node);
|
|
|
|
// Create a variable to save the sum.
|
|
$sum = 0;
|
|
|
|
// Run through all results.
|
|
foreach ( $results as $result )
|
|
{
|
|
// Get the value of the node.
|
|
$result = $this->get_content($result);
|
|
|
|
// Add it to the sum.
|
|
$sum += doubleval($result);
|
|
}
|
|
|
|
// Return the sum.
|
|
return $sum;
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function floor.
|
|
*
|
|
* This method handles the XPath function floor.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_floor ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Convert the arguments to a number.
|
|
$arguments = doubleval($arguments);
|
|
|
|
// Return the result
|
|
return floor($arguments);
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function ceiling.
|
|
*
|
|
* This method handles the XPath function ceiling.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_ceiling ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Convert the arguments to a number.
|
|
$arguments = doubleval($arguments);
|
|
|
|
// Return the result
|
|
return ceil($arguments);
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function round.
|
|
*
|
|
* This method handles the XPath function round.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_round ( $node, $arguments )
|
|
{
|
|
// Trim the arguments.
|
|
$arguments = trim($arguments);
|
|
|
|
// Convert the arguments to a number.
|
|
$arguments = doubleval($arguments);
|
|
|
|
// Return the result
|
|
return round($arguments);
|
|
}
|
|
|
|
/**
|
|
* Handles the XPath function text.
|
|
*
|
|
* This method handles the XPath function text.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $node Full path of the node on which the function
|
|
* should be processed.
|
|
* @param string $arguments String containing the arguments that were
|
|
* passed to the function.
|
|
* @return mixed Depending on the type of function being processed this
|
|
* method returns different types.
|
|
* @see evaluate()
|
|
*/
|
|
function handle_function_text ( $node, $arguments )
|
|
{
|
|
// Return the character data of the node.
|
|
return $this->nodes[$node]["text"];
|
|
}
|
|
|
|
/**
|
|
* Retrieves a substring before a delimiter.
|
|
*
|
|
* This method retrieves everything from a string before a given delimiter,
|
|
* not including the delimiter.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $string String, from which the substring should be
|
|
* extracted.
|
|
* @param string $delimiter String containing the delimiter to use.
|
|
* @return string Substring from the original string before the
|
|
* delimiter.
|
|
* @see afterstr()
|
|
*/
|
|
function prestr ( $string, $delimiter )
|
|
{
|
|
// Return the substring.
|
|
return substr($string, 0, strlen($string) - strlen(@strstr($string,$delimiter)));
|
|
}
|
|
|
|
/**
|
|
* Retrieves a substring after a delimiter.
|
|
*
|
|
* This method retrieves everything from a string after a given delimiter,
|
|
* not including the delimiter.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $string String, from which the substring should be
|
|
* extracted.
|
|
* @param string $delimiter String containing the delimiter to use.
|
|
* @return string Substring from the original string after the
|
|
* delimiter.
|
|
* @see prestr()
|
|
*/
|
|
function afterstr ( $string, $delimiter )
|
|
{
|
|
// Return the substring.
|
|
return substr($string,
|
|
strpos($string, $delimiter) + strlen($delimiter));
|
|
}
|
|
|
|
/**
|
|
* Displays an error message.
|
|
*
|
|
* This method displays an error messages and stops the execution of the
|
|
* script. This method is called exactly in the same way as the printf
|
|
* function. The first argument contains the message and additional
|
|
* arguments of various types may be passed to this method to be inserted
|
|
* into the message.
|
|
*
|
|
* @access private
|
|
* @author Michael P. Mehl <mpm@phpxml.org>
|
|
* @param string $message Error message to be displayed.
|
|
*/
|
|
function display_error ( $message )
|
|
{
|
|
// Check whether more than one argument was given.
|
|
if ( func_num_args() > 1 )
|
|
{
|
|
// Read all arguments.
|
|
$arguments = func_get_args();
|
|
|
|
// Create a new string for the inserting command.
|
|
$command = "\$message = sprintf(\$message, ";
|
|
|
|
// Run through the array of arguments.
|
|
for ( $i = 1; $i < sizeof($arguments); $i++ )
|
|
{
|
|
// Add the number of the argument to the command.
|
|
$command .= "\$arguments[".$i."], ";
|
|
}
|
|
|
|
// Replace the last separator.
|
|
$command = eregi_replace(", $", ");", $command);
|
|
|
|
// Execute the command.
|
|
eval($command);
|
|
}
|
|
|
|
// Display the error message.
|
|
echo "<b>phpXML error:</b> ".$message;
|
|
|
|
// End the execution of this script.
|
|
exit;
|
|
}
|
|
}
|
|
|
|
?>
|