PEAR マニュアル
前のページ次のページ

Config_Container::addItem()

Config_Container::addItem() -- このアイテムにアイテムを追加する

概要

require_once 'Config/Container.php';

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

説明

このメソッドは現在の子コンテナに子Config_Containerを加えるでしょう。 したがって、addItem() は単に1つのセクションタイプコンテナと呼ぶことができます。 位置が指定されれば、 オブジェクトはこの位置で加えられるでしょう。 もし'before'か'after' が位置として指定された場合、ターゲットオブジェクトが必要です。 are specified as position, a target object is required. その後、オブジェクトは、 現在のコンテナ中のターゲットオブジェクトの位置の前、 あるいはその位置の後に加えられるでしょう。

パラメータ

object &$item

コンテナオブジェクトです。

string $where

一の選択です。('bottom', 'top', 'after', 'before')

object $target

もし$whereで、 'before'か'after' を選択した場合に必要です。 $targetは、 このコンテナの子供のうちのひとつである必要があります。 ZendEngine2は、デフォルトでリファレンスを受け取ります。 その後、 &$target を代わりに持つことは可能でしょう。

返り値

object - 追加されたオブジェクトのリファレンスです。

例外・エラー

表 31-1PEAR_Error の値

エラーコードエラー値意味解決
 ""  

注意

この関数は、スタティックにコールする ことはできません。

例

例 31-1addItem()でアイテムを追加する使用例


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

例 31-2別のアイテムに関連する位置とaddItem()でアイテムを追加する使用例


<?php
$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()