PEAR Справочное руководство
Пред.		След.

Config_Container::addItem()

Config_Container::addItem() -- Add item to this item.

Synopsis

require_once 'Config/Container.php';

object Config_Container::addItem (object &$item [, string $where = 'bottom' [, object $target = NULL]])

Описание

This method will add a Config_Container child to the current container children. Thus, addItem() can only be called one a section type container. If a position is specified, the object will be added at this position. If 'before' or 'after' are specified as position, a target object is required. The object will then be added before or after the target object position in the current container.

Параметр

object &$item: a container object
string $where: choose a position 'bottom', 'top', 'after', 'before'
object $target: needed if you choose 'before' or 'after' in $where. $target must be one of this container's children. ZendEngine2 will accept references with default. It will then be possible to have &$target instead.

Возвращаемое значение

object - A reference to the added object

Throws

Таблица 32-1. Возможные значения PEAR_Error

Error code	Error value	Meaning	Solution
	""

Заметка

Эта функция не должна вызываться статически.

Пример

Пример 32-1. Adding an item using addItem()

$section =& new Config_Container('section', 'conf');
$directive =& new Config_Container('directive', 'user', 'mansion');
$section->addItem($directive);

Пример 32-2. Adding an item using addItem() and a position relative to another item

$section =& new Config_Container('section', 'conf');
$directive =& new Config_Container('directive', 'user', 'mansion');
$section->addItem($directive);

$comment =& new Config_Container('comment', null, 'Here goes my name');
$section->addItem($comment, 'before', $directive);

Пред.	Начало	След.
Config_Container::Config_Container()	Уровень выше	Config_Container::countChildren()

HIVE: All information for read only. Please respect copyright!