<?php



/*

$Id: class.nusoap_base.php,v 1.56 2010/04/26 20:15:08 snichol Exp $



NuSOAP - Web Services Toolkit for PHP



Copyright (c) 2002 NuSphere Corporation



This library is free software; you can redistribute it and/or

modify it under the terms of the GNU Lesser General Public

License as published by the Free Software Foundation; either

version 2.1 of the License, or (at your option) any later version.



This library is distributed in the hope that it will be useful,

but WITHOUT ANY WARRANTY; without even the implied warranty of

MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

Lesser General Public License for more details.



You should have received a copy of the GNU Lesser General Public

License along with this library; if not, write to the Free Software

Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA



The NuSOAP project home is:

http://sourceforge.net/projects/nusoap/



The primary support for NuSOAP is the Help forum on the project home page.



If you have any questions or comments, please email:



Dietrich Ayala

dietrich@ganx4.com

http://dietrich.ganx4.com/nusoap



NuSphere Corporation

http://www.nusphere.com



*/



/*

 *	Some of the standards implmented in whole or part by NuSOAP:

 *

 *	SOAP 1.1 (http://www.w3.org/TR/2000/NOTE-SOAP-20000508/)

 *	WSDL 1.1 (http://www.w3.org/TR/2001/NOTE-wsdl-20010315)

 *	SOAP Messages With Attachments (http://www.w3.org/TR/SOAP-attachments)

 *	XML 1.0 (http://www.w3.org/TR/2006/REC-xml-20060816/)

 *	Namespaces in XML 1.0 (http://www.w3.org/TR/2006/REC-xml-names-20060816/)

 *	XML Schema 1.0 (http://www.w3.org/TR/xmlschema-0/)

 *	RFC 2045 Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies

 *	RFC 2068 Hypertext Transfer Protocol -- HTTP/1.1

 *	RFC 2617 HTTP Authentication: Basic and Digest Access Authentication

 */



/* load classes



// necessary classes

require_once('class.soapclient.php');

require_once('class.soap_val.php');

require_once('class.soap_parser.php');

require_once('class.soap_fault.php');



// transport classes

require_once('class.soap_transport_http.php');



// optional add-on classes

require_once('class.xmlschema.php');

require_once('class.wsdl.php');



// server class

require_once('class.soap_server.php');*/



// class variable emulation

// cf. http://www.webkreator.com/php/techniques/php-static-class-variables.html

$GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'] = 9;



/**

*

* nusoap_base

*

* @author   Dietrich Ayala <dietrich@ganx4.com>

* @author   Scott Nichol <snichol@users.sourceforge.net>

* @version  $Id: class.nusoap_base.php,v 1.56 2010/04/26 20:15:08 snichol Exp $

* @access   public

*/

class nusoap_base {

	/**

	 * Identification for HTTP headers.

	 *

	 * @var string

	 * @access private

	 */

	var $title = 'NuSOAP';

	/**

	 * Version for HTTP headers.

	 *

	 * @var string

	 * @access private

	 */

	var $version = '0.9.5';

	/**

	 * CVS revision for HTTP headers.

	 *

	 * @var string

	 * @access private

	 */

	var $revision = '$Revision: 1.56 $';

    /**

     * Current error string (manipulated by getError/setError)

	 *

	 * @var string

	 * @access private

	 */

	var $error_str = '';

    /**

     * Current debug string (manipulated by debug/appendDebug/clearDebug/getDebug/getDebugAsXMLComment)

	 *

	 * @var string

	 * @access private

	 */

    var $debug_str = '';

    /**

	 * toggles automatic encoding of special characters as entities

	 * (should always be true, I think)

	 *

	 * @var boolean

	 * @access private

	 */

	var $charencoding = true;

	/**

	 * the debug level for this instance

	 *

	 * @var	integer

	 * @access private

	 */

	var $debugLevel;



    /**

	* set schema version

	*

	* @var      string

	* @access   public

	*/

	var $XMLSchemaVersion = 'http://www.w3.org/2001/XMLSchema';

	

    /**

	* charset encoding for outgoing messages

	*

	* @var      string

	* @access   public

	*/

    var $soap_defencoding = 'ISO-8859-1';

	//var $soap_defencoding = 'UTF-8';



	/**

	* namespaces in an array of prefix => uri

	*

	* this is "seeded" by a set of constants, but it may be altered by code

	*

	* @var      array

	* @access   public

	*/

	var $namespaces = array(

		'SOAP-ENV' => 'http://schemas.xmlsoap.org/soap/envelope/',

		'xsd' => 'http://www.w3.org/2001/XMLSchema',

		'xsi' => 'http://www.w3.org/2001/XMLSchema-instance',

		'SOAP-ENC' => 'http://schemas.xmlsoap.org/soap/encoding/'

		);



	/**

	* namespaces used in the current context, e.g. during serialization

	*

	* @var      array

	* @access   private

	*/

	var $usedNamespaces = array();



	/**

	* XML Schema types in an array of uri => (array of xml type => php type)

	* is this legacy yet?

	* no, this is used by the nusoap_xmlschema class to verify type => namespace mappings.

	* @var      array

	* @access   public

	*/

	var $typemap = array(

	'http://www.w3.org/2001/XMLSchema' => array(

		'string'=>'string','boolean'=>'boolean','float'=>'double','double'=>'double','decimal'=>'double',

		'duration'=>'','dateTime'=>'string','time'=>'string','date'=>'string','gYearMonth'=>'',

		'gYear'=>'','gMonthDay'=>'','gDay'=>'','gMonth'=>'','hexBinary'=>'string','base64Binary'=>'string',

		// abstract "any" types

		'anyType'=>'string','anySimpleType'=>'string',

		// derived datatypes

		'normalizedString'=>'string','token'=>'string','language'=>'','NMTOKEN'=>'','NMTOKENS'=>'','Name'=>'','NCName'=>'','ID'=>'',

		'IDREF'=>'','IDREFS'=>'','ENTITY'=>'','ENTITIES'=>'','integer'=>'integer','nonPositiveInteger'=>'integer',

		'negativeInteger'=>'integer','long'=>'integer','int'=>'integer','short'=>'integer','byte'=>'integer','nonNegativeInteger'=>'integer',

		'unsignedLong'=>'','unsignedInt'=>'','unsignedShort'=>'','unsignedByte'=>'','positiveInteger'=>''),

	'http://www.w3.org/2000/10/XMLSchema' => array(

		'i4'=>'','int'=>'integer','boolean'=>'boolean','string'=>'string','double'=>'double',

		'float'=>'double','dateTime'=>'string',

		'timeInstant'=>'string','base64Binary'=>'string','base64'=>'string','ur-type'=>'array'),

	'http://www.w3.org/1999/XMLSchema' => array(

		'i4'=>'','int'=>'integer','boolean'=>'boolean','string'=>'string','double'=>'double',

		'float'=>'double','dateTime'=>'string',

		'timeInstant'=>'string','base64Binary'=>'string','base64'=>'string','ur-type'=>'array'),

	'http://soapinterop.org/xsd' => array('SOAPStruct'=>'struct'),

	'http://schemas.xmlsoap.org/soap/encoding/' => array('base64'=>'string','array'=>'array','Array'=>'array'),

    'http://xml.apache.org/xml-soap' => array('Map')

	);



	/**

	* XML entities to convert

	*

	* @var      array

	* @access   public

	* @deprecated

	* @see	expandEntities

	*/

	var $xmlEntities = array('quot' => '"','amp' => '&',

		'lt' => '<','gt' => '>','apos' => "'");



	/**

	* constructor

	*

	* @access	public

	*/

	function nusoap_base() {

		$this->debugLevel = $GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'];

	}



	/**

	* gets the global debug level, which applies to future instances

	*

	* @return	integer	Debug level 0-9, where 0 turns off

	* @access	public

	*/

	function getGlobalDebugLevel() {

		return $GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'];

	}



	/**

	* sets the global debug level, which applies to future instances

	*

	* @param	int	$level	Debug level 0-9, where 0 turns off

	* @access	public

	*/

	function setGlobalDebugLevel($level) {

		$GLOBALS['_transient']['static']['nusoap_base']['globalDebugLevel'] = $level;

	}



	/**

	* gets the debug level for this instance

	*

	* @return	int	Debug level 0-9, where 0 turns off

	* @access	public

	*/

	function getDebugLevel() {

		return $this->debugLevel;

	}



	/**

	* sets the debug level for this instance

	*

	* @param	int	$level	Debug level 0-9, where 0 turns off

	* @access	public

	*/

	function setDebugLevel($level) {

		$this->debugLevel = $level;

	}



	/**

	* adds debug data to the instance debug string with formatting

	*

	* @param    string $string debug data

	* @access   private

	*/

	function debug($string){

		if ($this->debugLevel > 0) {

			$this->appendDebug($this->getmicrotime().' '.get_class($this).": $string\n");

		}

	}



	/**

	* adds debug data to the instance debug string without formatting

	*

	* @param    string $string debug data

	* @access   public

	*/

	function appendDebug($string){

		if ($this->debugLevel > 0) {

			// it would be nice to use a memory stream here to use

			// memory more efficiently

			$this->debug_str .= $string;

		}

	}



	/**

	* clears the current debug data for this instance

	*

	* @access   public

	*/

	function clearDebug() {

		// it would be nice to use a memory stream here to use

		// memory more efficiently

		$this->debug_str = '';

	}



	/**

	* gets the current debug data for this instance

	*

	* @return   debug data

	* @access   public

	*/

	function &getDebug() {

		// it would be nice to use a memory stream here to use

		// memory more efficiently

		return $this->debug_str;

	}



	/**

	* gets the current debug data for this instance as an XML comment

	* this may change the contents of the debug data

	*

	* @return   debug data as an XML comment

	* @access   public

	*/

	function &getDebugAsXMLComment() {

		// it would be nice to use a memory stream here to use

		// memory more efficiently

		while (strpos($this->debug_str, '--')) {

			$this->debug_str = str_replace('--', '- -', $this->debug_str);

		}

		$ret = "<!--\n" . $this->debug_str . "\n-->";

    	return $ret;

	}



	/**

	* expands entities, e.g. changes '<' to '&lt;'.

	*

	* @param	string	$val	The string in which to expand entities.

	* @access	private

	*/

	function expandEntities($val) {

		if ($this->charencoding) {

	    	$val = str_replace('&', '&amp;', $val);

	    	$val = str_replace("'", '&apos;', $val);

	    	$val = str_replace('"', '&quot;', $val);

	    	$val = str_replace('<', '&lt;', $val);

	    	$val = str_replace('>', '&gt;', $val);

	    }

	    return $val;

	}



	/**

	* returns error string if present

	*

	* @return   mixed error string or false

	* @access   public

	*/

	function getError(){

		if($this->error_str != ''){

			return $this->error_str;

		}

		return false;

	}



	/**

	* sets error string

	*

	* @return   boolean $string error string

	* @access   private

	*/

	function setError($str){

		$this->error_str = $str;

	}



	/**

	* detect if array is a simple array or a struct (associative array)

	*

	* @param	mixed	$val	The PHP array

	* @return	string	(arraySimple|arrayStruct)

	* @access	private

	*/

	function isArraySimpleOrStruct($val) {

        $keyList = array_keys($val);

		foreach ($keyList as $keyListValue) {

			if (!is_int($keyListValue)) {

				return 'arrayStruct';

			}

		}

		return 'arraySimple';

	}



	/**

	* serializes PHP values in accordance w/ section 5. Type information is

	* not serialized if $use == 'literal'.

	*

	* @param	mixed	$val	The value to serialize

	* @param	string	$name	The name (local part) of the XML element

	* @param	string	$type	The XML schema type (local part) for the element

	* @param	string	$name_ns	The namespace for the name of the XML element

	* @param	string	$type_ns	The namespace for the type of the element

	* @param	array	$attributes	The attributes to serialize as name=>value pairs

	* @param	string	$use	The WSDL "use" (encoded|literal)

	* @param	boolean	$soapval	Whether this is called from soapval.

	* @return	string	The serialized element, possibly with child elements

    * @access	public

	*/

	function serialize_val($val,$name=false,$type=false,$name_ns=false,$type_ns=false,$attributes=false,$use='encoded',$soapval=false) {

		$this->debug("in serialize_val: name=$name, type=$type, name_ns=$name_ns, type_ns=$type_ns, use=$use, soapval=$soapval");

		$this->appendDebug('value=' . $this->varDump($val));

		$this->appendDebug('attributes=' . $this->varDump($attributes));

		

    	if (is_object($val) && get_class($val) == 'soapval' && (! $soapval)) {

    		$this->debug("serialize_val: serialize soapval");

        	$xml = $val->serialize($use);

			$this->appendDebug($val->getDebug());

			$val->clearDebug();

			$this->debug("serialize_val of soapval returning $xml");

			return $xml;

        }

		// force valid name if necessary

		if (is_numeric($name)) {

			$name = '__numeric_' . $name;

		} elseif (! $name) {

			$name = 'noname';

		}

		// if name has ns, add ns prefix to name

		$xmlns = '';

        if($name_ns){

			$prefix = 'nu'.rand(1000,9999);

			$name = $prefix.':'.$name;

			$xmlns .= " xmlns:$prefix=\"$name_ns\"";

		}

		// if type is prefixed, create type prefix

		if($type_ns != '' && $type_ns == $this->namespaces['xsd']){

			// need to fix this. shouldn't default to xsd if no ns specified

		    // w/o checking against typemap

			$type_prefix = 'xsd';

		} elseif($type_ns){

			$type_prefix = 'ns'.rand(1000,9999);

			$xmlns .= " xmlns:$type_prefix=\"$type_ns\"";

		}

		// serialize attributes if present

		$atts = '';

		if($attributes){

			foreach($attributes as $k => $v){

				$atts .= " $k=\"".$this->expandEntities($v).'"';

			}

		}

		// serialize null value

		if (is_null($val)) {

    		$this->debug("serialize_val: serialize null");

			if ($use == 'literal') {

				// TODO: depends on minOccurs

				$xml = "<$name$xmlns$atts/>";

				$this->debug("serialize_val returning $xml");

	        	return $xml;

        	} else {

				if (isset($type) && isset($type_prefix)) {

					$type_str = " xsi:type=\"$type_prefix:$type\"";

				} else {

					$type_str = '';

				}

				$xml = "<$name$xmlns$type_str$atts xsi:nil=\"true\"/>";

				$this->debug("serialize_val returning $xml");

	        	return $xml;

        	}

		}

        // serialize if an xsd built-in primitive type

        if($type != '' && isset($this->typemap[$this->XMLSchemaVersion][$type])){

    		$this->debug("serialize_val: serialize xsd built-in primitive type");

        	if (is_bool($val)) {

        		if ($type == 'boolean') {

	        		$val = $val ? 'true' : 'false';

	        	} elseif (! $val) {

	        		$val = 0;

	        	}

			} else if (is_string($val)) {

				$val = $this->expandEntities($val);

			}

			if ($use == 'literal') {

				$xml = "<$name$xmlns$atts>$val</$name>";

				$this->debug("serialize_val returning $xml");

	        	return $xml;

        	} else {

				$xml = "<$name$xmlns xsi:type=\"xsd:$type\"$atts>$val</$name>";

				$this->debug("serialize_val returning $xml");

	        	return $xml;

        	}

        }

		// detect type and serialize

		$xml = '';

		switch(true) {

			case (is_bool($val) || $type == 'boolean'):

		   		$this->debug("serialize_val: serialize boolean");

        		if ($type == 'boolean') {

	        		$val = $val ? 'true' : 'false';

	        	} elseif (! $val) {

	        		$val = 0;

	        	}

				if ($use == 'literal') {

					$xml .= "<$name$xmlns$atts>$val</$name>";

				} else {

					$xml .= "<$name$xmlns xsi:type=\"xsd:boolean\"$atts>$val</$name>";

				}

				break;

			case (is_int($val) || is_long($val) || $type == 'int'):

		   		$this->debug("serialize_val: serialize int");

				if ($use == 'literal') {

					$xml .= "<$name$xmlns$atts>$val</$name>";

				} else {

					$xml .= "<$name$xmlns xsi:type=\"xsd:int\"$atts>$val</$name>";

				}

				break;

			case (is_float($val)|| is_double($val) || $type == 'float'):

		   		$this->debug("serialize_val: serialize float");

				if ($use == 'literal') {

					$xml .= "<$name$xmlns$atts>$val</$name>";

				} else {

					$xml .= "<$name$xmlns xsi:type=\"xsd:float\"$atts>$val</$name>";

				}

				break;

			case (is_string($val) || $type == 'string'):

		   		$this->debug("serialize_val: serialize string");

				$val = $this->expandEntities($val);

				if ($use == 'literal') {

					$xml .= "<$name$xmlns$atts>$val</$name>";

				} else {

					$xml .= "<$name$xmlns xsi:type=\"xsd:string\"$atts>$val</$name>";

				}

				break;

			case is_object($val):

		   		$this->debug("serialize_val: serialize object");

		    	if (get_class($val) == 'soapval') {

		    		$this->debug("serialize_val: serialize soapval object");

		        	$pXml = $val->serialize($use);

					$this->appendDebug($val->getDebug());

					$val->clearDebug();

		        } else {

					if (! $name) {

						$name = get_class($val);

						$this->debug("In serialize_val, used class name $name as element name");

					} else {

						$this->debug("In serialize_val, do not override name $name for element name for class " . get_class($val));

					}

					foreach(get_object_vars($val) as $k => $v){

						$pXml = isset($pXml) ? $pXml.$this->serialize_val($v,$k,false,false,false,false,$use) : $this->serialize_val($v,$k,false,false,false,false,$use);

					}

				}

				if(isset($type) && isset($type_prefix)){

					$type_str = " xsi:type=\"$type_prefix:$type\"";

				} else {

					$type_str = '';

				}

				if ($use == 'literal') {

					$xml .= "<$name$xmlns$atts>$pXml</$name>";

				} else {

					$xml .= "<$name$xmlns$type_str$atts>$pXml</$name>";

				}

				break;

			break;

			case (is_array($val) || $type):

				// detect if struct or array

				$valueType = $this->isArraySimpleOrStruct($val);

                if($valueType=='arraySimple' || preg_match('/^ArrayOf/',$type)){

			   		$this->debug("serialize_val: serialize array");

					$i = 0;

					if(is_array($val) && count($val)> 0){

						foreach($val as $v){

	                    	if(is_object($v) && get_class($v) ==  'soapval'){

								$tt_ns = $v->type_ns;

								$tt = $v->type;

							} elseif (is_array($v)) {

								$tt = $this->isArraySimpleOrStruct($v);

							} else {

								$tt = gettype($v);

	                        }

							$array_types[$tt] = 1;

							// TODO: for literal, the name should be $name

							$xml .= $this->serialize_val($v,'item',false,false,false,false,$use);

							++$i;

						}

						if(count($array_types) > 1){

							$array_typename = 'xsd:anyType';

						} elseif(isset($tt) && isset($this->typemap[$this->XMLSchemaVersion][$tt])) {

							if ($tt == 'integer') {

								$tt = 'int';

							}

							$array_typename = 'xsd:'.$tt;

						} elseif(isset($tt) && $tt == 'arraySimple'){

							$array_typename = 'SOAP-ENC:Array';

						} elseif(isset($tt) && $tt == 'arrayStruct'){

							$array_typename = 'unnamed_struct_use_soapval';

						} else {

							// if type is prefixed, create type prefix

							if ($tt_ns != '' && $tt_ns == $this->namespaces['xsd']){

								 $array_typename = 'xsd:' . $tt;

							} elseif ($tt_ns) {

								$tt_prefix = 'ns' . rand(1000, 9999);

								$array_typename = "$tt_prefix:$tt";

								$xmlns .= " xmlns:$tt_prefix=\"$tt_ns\"";

							} else {

								$array_typename = $tt;

							}

						}

						$array_type = $i;

						if ($use == 'literal') {

							$type_str = '';

						} else if (isset($type) && isset($type_prefix)) {

							$type_str = " xsi:type=\"$type_prefix:$type\"";

						} else {

							$type_str = " xsi:type=\"SOAP-ENC:Array\" SOAP-ENC:arrayType=\"".$array_typename."[$array_type]\"";

						}

					// empty array

					} else {

						if ($use == 'literal') {

							$type_str = '';

						} else if (isset($type) && isset($type_prefix)) {

							$type_str = " xsi:type=\"$type_prefix:$type\"";

						} else {

							$type_str = " xsi:type=\"SOAP-ENC:Array\" SOAP-ENC:arrayType=\"xsd:anyType[0]\"";

						}

					}

					// TODO: for array in literal, there is no wrapper here

					$xml = "<$name$xmlns$type_str$atts>".$xml."</$name>";

				} else {

					// got a struct

			   		$this->debug("serialize_val: serialize struct");

					if(isset($type) && isset($type_prefix)){

						$type_str = " xsi:type=\"$type_prefix:$type\"";

					} else {

						$type_str = '';

					}

					if ($use == 'literal') {

						$xml .= "<$name$xmlns$atts>";

					} else {

						$xml .= "<$name$xmlns$type_str$atts>";

					}

					foreach($val as $k => $v){

						// Apache Map

						if ($type == 'Map' && $type_ns == 'http://xml.apache.org/xml-soap') {

							$xml .= '<item>';

							$xml .= $this->serialize_val($k,'key',false,false,false,false,$use);

							$xml .= $this->serialize_val($v,'value',false,false,false,false,$use);

							$xml .= '</item>';

						} else {

							$xml .= $this->serialize_val($v,$k,false,false,false,false,$use);

						}

					}

					$xml .= "</$name>";

				}

				break;

			default:

		   		$this->debug("serialize_val: serialize unknown");

				$xml .= 'not detected, got '.gettype($val).' for '.$val;

				break;

		}

		$this->debug("serialize_val returning $xml");

		return $xml;

	}



    /**

    * serializes a message

    *

    * @param string $body the XML of the SOAP body

    * @param mixed $headers optional string of XML with SOAP header content, or array of soapval objects for SOAP headers, or associative array

    * @param array $namespaces optional the namespaces used in generating the body and headers

    * @param string $style optional (rpc|document)

    * @param string $use optional (encoded|literal)

    * @param string $encodingStyle optional (usually 'http://schemas.xmlsoap.org/soap/encoding/' for encoded)

    * @return string the message

    * @access public

    */

    function serializeEnvelope($body,$headers=false,$namespaces=array(),$style='rpc',$use='encoded',$encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'){

    // TODO: add an option to automatically run utf8_encode on $body and $headers

    // if $this->soap_defencoding is UTF-8.  Not doing this automatically allows

    // one to send arbitrary UTF-8 characters, not just characters that map to ISO-8859-1



	$this->debug("In serializeEnvelope length=" . strlen($body) . " body (max 1000 characters)=" . substr($body, 0, 1000) . " style=$style use=$use encodingStyle=$encodingStyle");

	$this->debug("headers:");

	$this->appendDebug($this->varDump($headers));

	$this->debug("namespaces:");

	$this->appendDebug($this->varDump($namespaces));



	// serialize namespaces

    $ns_string = '';

	foreach(array_merge($this->namespaces,$namespaces) as $k => $v){

		$ns_string .= " xmlns:$k=\"$v\"";

	}

	if($encodingStyle) {

		$ns_string = " SOAP-ENV:encodingStyle=\"$encodingStyle\"$ns_string";

	}



	// serialize headers

	if($headers){

		if (is_array($headers)) {

			$xml = '';

			foreach ($headers as $k => $v) {

				if (is_object($v) && get_class($v) == 'soapval') {

					$xml .= $this->serialize_val($v, false, false, false, false, false, $use);

				} else {

					$xml .= $this->serialize_val($v, $k, false, false, false, false, $use);

				}

			}

			$headers = $xml;

			$this->debug("In serializeEnvelope, serialized array of headers to $headers");

		}

		$headers = "<SOAP-ENV:Header>".$headers."</SOAP-ENV:Header>";

	}

	// serialize envelope

	return

	'<?xml version="1.0" encoding="'.$this->soap_defencoding .'"?'.">".

	'<SOAP-ENV:Envelope'.$ns_string.">".

	$headers.

	"<SOAP-ENV:Body>".

		$body.

	"</SOAP-ENV:Body>".

	"</SOAP-ENV:Envelope>";

    }



	/**

	 * formats a string to be inserted into an HTML stream

	 *

	 * @param string $str The string to format

	 * @return string The formatted string

	 * @access public

	 * @deprecated

	 */

    function formatDump($str){

		$str = htmlspecialchars($str);

		return nl2br($str);

    }



	/**

	* contracts (changes namespace to prefix) a qualified name

	*

	* @param    string $qname qname

	* @return	string contracted qname

	* @access   private

	*/

	function contractQname($qname){

		// get element namespace

		//$this->xdebug("Contract $qname");

		if (strrpos($qname, ':')) {

			// get unqualified name

			$name = substr($qname, strrpos($qname, ':') + 1);

			// get ns

			$ns = substr($qname, 0, strrpos($qname, ':'));

			$p = $this->getPrefixFromNamespace($ns);

			if ($p) {

				return $p . ':' . $name;

			}

			return $qname;

		} else {

			return $qname;

		}

	}



	/**

	* expands (changes prefix to namespace) a qualified name

	*

	* @param    string $qname qname

	* @return	string expanded qname

	* @access   private

	*/

	function expandQname($qname){

		// get element prefix

		if(strpos($qname,':') && !preg_match('/^http:\/\//',$qname)){

			// get unqualified name

			$name = substr(strstr($qname,':'),1);

			// get ns prefix

			$prefix = substr($qname,0,strpos($qname,':'));

			if(isset($this->namespaces[$prefix])){

				return $this->namespaces[$prefix].':'.$name;

			} else {

				return $qname;

			}

		} else {

			return $qname;

		}

	}



    /**

    * returns the local part of a prefixed string

    * returns the original string, if not prefixed

    *

    * @param string $str The prefixed string

    * @return string The local part

    * @access public

    */

	function getLocalPart($str){

		if($sstr = strrchr($str,':')){

			// get unqualified name

			return substr( $sstr, 1 );

		} else {

			return $str;

		}

	}



	/**

    * returns the prefix part of a prefixed string

    * returns false, if not prefixed

    *

    * @param string $str The prefixed string

    * @return mixed The prefix or false if there is no prefix

    * @access public

    */

	function getPrefix($str){

		if($pos = strrpos($str,':')){

			// get prefix

			return substr($str,0,$pos);

		}

		return false;

	}



	/**

    * pass it a prefix, it returns a namespace

    *

    * @param string $prefix The prefix

    * @return mixed The namespace, false if no namespace has the specified prefix

    * @access public

    */

	function getNamespaceFromPrefix($prefix){

		if (isset($this->namespaces[$prefix])) {

			return $this->namespaces[$prefix];

		}

		//$this->setError("No namespace registered for prefix '$prefix'");

		return false;

	}



	/**

    * returns the prefix for a given namespace (or prefix)

    * or false if no prefixes registered for the given namespace

    *

    * @param string $ns The namespace

    * @return mixed The prefix, false if the namespace has no prefixes

    * @access public

    */

	function getPrefixFromNamespace($ns) {

		foreach ($this->namespaces as $p => $n) {

			if ($ns == $n || $ns == $p) {

			    $this->usedNamespaces[$p] = $n;

				return $p;

			}

		}

		return false;

	}



	/**

    * returns the time in ODBC canonical form with microseconds

    *

    * @return string The time in ODBC canonical form with microseconds

    * @access public

    */

	function getmicrotime() {

		if (function_exists('gettimeofday')) {

			$tod = gettimeofday();

			$sec = $tod['sec'];

			$usec = $tod['usec'];

		} else {

			$sec = time();

			$usec = 0;

		}

		return strftime('%Y-%m-%d %H:%M:%S', $sec) . '.' . sprintf('%06d', $usec);

	}



	/**

	 * Returns a string with the output of var_dump

	 *

	 * @param mixed $data The variable to var_dump

	 * @return string The output of var_dump

	 * @access public

	 */

    function varDump($data) {

		ob_start();

		var_dump($data);

		$ret_val = ob_get_contents();

		ob_end_clean();

		return $ret_val;

	}



	/**

	* represents the object as a string

	*

	* @return	string

	* @access   public

	*/

	function __toString() {

		return $this->varDump($this);

	}

}



// XML Schema Datatype Helper Functions



//xsd:dateTime helpers



/**

* convert unix timestamp to ISO 8601 compliant date string

*

* @param    int $timestamp Unix time stamp

* @param	boolean $utc Whether the time stamp is UTC or local

* @return	mixed ISO 8601 date string or false

* @access   public

*/

function timestamp_to_iso8601($timestamp,$utc=true){

	$datestr = date('Y-m-d\TH:i:sO',$timestamp);

	$pos = strrpos($datestr, "+");

	if ($pos === FALSE) {

		$pos = strrpos($datestr, "-");

	}

	if ($pos !== FALSE) {

		if (strlen($datestr) == $pos + 5) {

			$datestr = substr($datestr, 0, $pos + 3) . ':' . substr($datestr, -2);

		}

	}

	if($utc){

		$pattern = '/'.

		'([0-9]{4})-'.	// centuries & years CCYY-

		'([0-9]{2})-'.	// months MM-

		'([0-9]{2})'.	// days DD

		'T'.			// separator T

		'([0-9]{2}):'.	// hours hh:

		'([0-9]{2}):'.	// minutes mm:

		'([0-9]{2})(\.[0-9]*)?'. // seconds ss.ss...

		'(Z|[+\-][0-9]{2}:?[0-9]{2})?'. // Z to indicate UTC, -/+HH:MM:SS.SS... for local tz's

		'/';



		if(preg_match($pattern,$datestr,$regs)){

			return sprintf('%04d-%02d-%02dT%02d:%02d:%02dZ',$regs[1],$regs[2],$regs[3],$regs[4],$regs[5],$regs[6]);

		}

		return false;

	} else {

		return $datestr;

	}

}



/**

* convert ISO 8601 compliant date string to unix timestamp

*

* @param    string $datestr ISO 8601 compliant date string

* @return	mixed Unix timestamp (int) or false

* @access   public

*/

function iso8601_to_timestamp($datestr){

	$pattern = '/'.

	'([0-9]{4})-'.	// centuries & years CCYY-

	'([0-9]{2})-'.	// months MM-

	'([0-9]{2})'.	// days DD

	'T'.			// separator T

	'([0-9]{2}):'.	// hours hh:

	'([0-9]{2}):'.	// minutes mm:

	'([0-9]{2})(\.[0-9]+)?'. // seconds ss.ss...

	'(Z|[+\-][0-9]{2}:?[0-9]{2})?'. // Z to indicate UTC, -/+HH:MM:SS.SS... for local tz's

	'/';

	if(preg_match($pattern,$datestr,$regs)){

		// not utc

		if($regs[8] != 'Z'){

			$op = substr($regs[8],0,1);

			$h = substr($regs[8],1,2);

			$m = substr($regs[8],strlen($regs[8])-2,2);

			if($op == '-'){

				$regs[4] = $regs[4] + $h;

				$regs[5] = $regs[5] + $m;

			} elseif($op == '+'){

				$regs[4] = $regs[4] - $h;

				$regs[5] = $regs[5] - $m;

			}

		}

		return gmmktime($regs[4], $regs[5], $regs[6], $regs[2], $regs[3], $regs[1]);

//		return strtotime("$regs[1]-$regs[2]-$regs[3] $regs[4]:$regs[5]:$regs[6]Z");

	} else {

		return false;

	}

}



/**

* sleeps some number of microseconds

*

* @param    string $usec the number of microseconds to sleep

* @access   public

* @deprecated

*/

function usleepWindows($usec)

{

	$start = gettimeofday();

	

	do

	{

		$stop = gettimeofday();

		$timePassed = 1000000 * ($stop['sec'] - $start['sec'])

		+ $stop['usec'] - $start['usec'];

	}

	while ($timePassed < $usec);

}





?>