File Source for ABSTObject.class.php

<?php
/**
* @package data_structures
*/
if (
version_compare( phpversion(), '5.0' ) < 0
&& !function_exists( "clone" )
)
{
eval( '
function clone( $object )
{ return $object; }
');
}
/**
* Class to inspect objects that are an extension of this class.
*
* @package data_structures
* @version 0.1.24
* @since 0.9.3.3
* @abstract
* @author Daniel Plücken <daniel@debakel.net>
* @license http://www.gnu.org/copyleft/lesser.html
* GNU Lesser General Public License
* @copyright Copyright (C) 2007 Daniel Plücken <daniel@debakel.net>
*
* 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.
*
* 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
*/
class ABSTObject
{
/**
* Prints out the primitive data by the given arrays.
*
* @require PHP 4
* @version 1.0
* @since 0.1.0
* @access public
*
* @return void
*
* @author Daniel Plücken <daniel.pluecken@wfp2.com>
*/
function printPrimitiveData(
&$primitive_types_arr,
&$primitive_array_arr
)
{
if (
count( $primitive_types_arr )
+ count( $primitive_array_arr ) > 0
)
{
echo "<p>\r\n";
echo "<h2>Primitive Data:</h2>\r\n";
echo "<blockquote>\r\n";
foreach ( $primitive_types_arr as $nam => $value )
{
$value = preg_replace( "![\r\n]+!s", "", strip_tags($value) );
if ( strlen( $value ) < 256 )
echo "<b>{$nam}</b>: {$value}<br />\r\n";
else
echo "<b>{$nam}</b>: ".substr( $value, 0, 255 )
." [...]<br />\r\n";
}
foreach ( $primitive_array_arr as $nam => $value )
{
echo "<b>{$nam}:</b> ";
print_r( $value );
echo "<br />\r\n";
}
echo "</blockquote>\r\n";
echo "</p>\r\n";
}
}
/**
* Prints out the more complex data by the given array.
*
* @access public
* @require PHP 4
* @version 1.0
* @since 0.1.0
*
* @param array $multidimensional_arr
* @param array $depth_arr
* @param string $exept_reg_exp
*
* @return void
*
* @author Daniel Plücken <daniel.pluecken@wfp2.com>
*/
function printComplexData(
&$multidimensional_arr,
$depth_arr = array(),
$exept_reg_exp = null
)
{
$dig_deeper_arr = array();
$handled_object_arr = array();
$unhandled_object_arr = array();
foreach ( $multidimensional_arr as $key => $val )
{
if (
is_object( $multidimensional_arr[$key] )
&& !method_exists ( $multidimensional_arr[$key], "printStructure" )
)
$unhandled_object_arr[$key] =& $multidimensional_arr[$key];
else
if ( is_object( $multidimensional_arr[$key] ) )
$handled_object_arr[$key] =& $multidimensional_arr[$key];
else
if ( is_array( $multidimensional_arr[$key] ) )
$dig_deeper_arr[$key] =& $multidimensional_arr[$key];
}
$mem_depth_arr = $depth_arr;
$nam_prefix = array_shift( $depth_arr );
if ( count( $depth_arr ) > 1 )
$nam_prefix .= "[".implode( "][", $depth_arr )."]";
foreach ( $unhandled_object_arr as $nam => $value )
{
echo "<b>{$nam_prefix}[{$nam}]</b>: *Object ";
echo get_class( $unhandled_object_arr[$nam] );
echo " (unhandled)<br />\r\n";
}
foreach ( $handled_object_arr as $nam => $value )
{
echo "<b>{$nam_prefix}[{$nam}]</b>:\r\n";
echo "<blockquote>";
echo $handled_object_arr[$nam]->printStructure( $exept_reg_exp );
echo "</blockquote>";
echo "<br />\r\n";
}
$depth_arr = $mem_depth_arr;
foreach ( $dig_deeper_arr as $nam => $value )
{
$depth_arr[] = $nam;
$this->printComplexData(
$dig_deeper_arr[$nam],
$depth_arr,
$exept_reg_exp
);
$depth_arr = $mem_depth_arr;
}
}
/**
* Compares two references whether they points to the same object
*
* @static
* @access public
* @require PHP 4
* @version 1.0
* @since 0.1.24
*
* @param object $a_obj
* @param object $b_obj
*
* @return boolean
*/
function sameReferences( &$a_obj, &$b_obj )
{
$a_obj->____bool_same_checker = true;
$bool_out = !empty( $b_obj->____bool_same_checker );
unset( $a_obj->____bool_same_checker );
return $bool_out;
}
/**
* Checks whether the passed object reference points to this object.
*
* @require PHP 4
* @version 1.0
* @since 0.1.24
* @access public
*
* @param ABSTObject $obj
*
* @return boolean
*/
function same( &$obj )
{
if ( !is_a( $obj, "ABSTObject" ) )
{ return false; }
return ABSTObject::sameReferences( $this, $obj );
}
/**
* Prints out the Structure of this Object.
*
* @access public
* @require PHP 4
* @version 1.01
* @since 0.1.0
*
* @param string $exept_reg_exp No Fieldnames that match this regular
* expression will print out.
*
* @return void
*/
function printStructure( $exept_reg_exp = null )
{
$handled_object_arr = array();
$primitive_types_arr = array();
$primitive_array_arr = array();
$multidimensional_arr = array();
$unhandled_object_arr = array();
# Getting Fields
foreach ( $this as $key => $val )
if (
!is_string( $exept_reg_exp )
|| !preg_match( $exept_reg_exp, $key )
)
{
if (
is_object( $this->$key )
&& method_exists ( $this->$key, "printStructure" )
)
{ $handled_object_arr[$key] =& $this->$key; }
else
if ( is_object( $this->$key ) )
{ $unhandled_object_arr[$key] =& $this->$key; }
else
if ( !is_array( $this->$key ) )
{ $primitive_types_arr[$key] =& $this->$key; }
else
{
$is_complex = false;
foreach ( $this->$key as $kval )
if ( is_array( $kval ) || is_object( $kval ) )
{
$is_complex = true;
break;
}
if ( $is_complex )
$multidimensional_arr[$key] =& $this->$key;
else
$primitive_array_arr[$key] =& $this->$key;
}
}
echo "<h1>Object: ".get_class( $this )."</h1>";
$this->printPrimitiveData(
$primitive_types_arr,
$primitive_array_arr
);
if ( count( $multidimensional_arr ) > 0 )
{
ob_start();
$this->printComplexData(
$multidimensional_arr,
array(), $exept_reg_exp
);
$cont = ob_get_contents();
ob_end_clean();
echo "<p>\r\n";
echo "<h2>Complex Data <font size=\"1\">["
.get_class( $this )
."]</font>:</h2>\r\n";
echo "<blockquote>\r\n";
if ( !empty( $cont ) )
echo $cont;
else
echo "{Some multidimensional arrays without references to "
."objects (I think not neccessary to display!)}";
echo "</blockquote>\r\n";
echo "</p>\r\n";
}
if ( count( $unhandled_object_arr ) > 0 )
{
echo "<p>\r\n";
echo "<h2>Unhandled Objects <font size=\"1\">["
.get_class( $this )
."]</font>:</h2>\r\n";
echo "<blockquote>\r\n";
foreach ( $unhandled_object_arr as $nam => $value )
echo "<b>{$nam}</b>: *Object "
.get_class( $unhandled_object_arr[$nam] )
."<br />\r\n";
echo "</blockquote>\r\n";
echo "</p>\r\n";
}
if ( count( $handled_object_arr ) > 0 )
{
echo "<p>\r\n";
echo "<h2>Handled Objects <font size=\"1\">["
.get_class( $this )
."]</font>:</h2>\r\n";
echo "<blockquote>\r\n";
foreach ( $handled_object_arr as $nam => $value )
{
echo "<b>{$nam}</b>:\r\n";
echo "<blockquote>\r\n";
echo $handled_object_arr[$nam]->printStructure($exept_reg_exp);
echo "</blockquote>\r\n";
echo "<br />\r\n";
}
echo "</blockquote>\r\n";
echo "</p>\r\n";
}
}
} // End of class ABSTObject
?>

Source for file ABSTObject.class.php