API16

JObject

From Joomla! Documentation

The "API16" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

JObject is a generic object class. It provides:

  • Joomla 1.5 a mechanism that allows __construct() in PHP4;
  • operations for creating and accessing arbitrary object variables;
  • an array for storing errors (ordinary strings or JException objects) and operations for working with them.

Defined in[edit]

libraries/joomla/base/object.php

Methods[edit]

Method name Description
__construct Class constructor, overridden in descendant classes.
__toString Magic method to convert the object to a string gracefully.
def Sets a default value if not alreay assigned
get Returns a property of the object or the default value if the property is not set.
getProperties Returns an associative array of object properties.
getError Get the most recent error message.
getErrors Return all errors, if any.
set Modifies a property of the object, creating it if it does not already exist.
setProperties Set the object properties based on a named array/hash.
setError Add an error message.
toString Deprecated1.6 - Jun 24, 2009 __toString()

Importing[edit]

jimport( 'joomla.base.object' );



Examples[edit]

Code Examples[edit]

Example

$bunny = new JObject;
$bunny->set('animalType', 'hare');
$bunny->set('color', 'white');
$bunny->set('ears', 2);

$wolfy = new JObject;
$wolfy->setProperties(
                     array(
                           'animalType'=>'wolf',
                           'color'=>'grey',
                           'teeth'=>42,
                           'stomach'=>null
                           )
                     );


$wolfy->stomach = $bunny;

print_r($wolfy);

would output

JObject Object
(
    [_errors] => Array
        (
        )

    [animalType] => wolf
    [color] => grey
    [teeth] => 42
    [stomach] => JObject Object
        (
            [_errors] => Array
                (
                )

            [animalType] => hare
            [color] => white
            [ears] => 2
        )

)

This example was originally provided by Artyom.


Chris Davenport 04:43, 17 April 2011 (CDT) Edit comment