CAttributeCollection

$collection->text='text'; // same as:  $collection->add('text','text');
echo $collection->text;   // same as:  echo $collection->itemAt('text');

Подробное описание свойств

caseSensitive свойство

public boolean $caseSensitive;

указывает, чувствительны ли ключи к регистру. По умолчанию false.

Подробное описание методов

__get() метод

public mixed __get(string $name)

public function __get($name)
{
    if($this->contains($name))
        return $this->itemAt($name);
    else
        return parent::__get($name);
}

Возвращает значение свойства или список обработчиков событий по имени свойства или события. Этот метод переопределяет реализацию родительского класса, возвращая значение ключа, если ключ существует в коллекции.

__isset() метод

public boolean __isset(string $name)

public function __isset($name)
{
    if($this->contains($name))
        return $this->itemAt($name)!==null;
    else
        return parent::__isset($name);
}

Проверяет, является ли значение свойства null. Этот метод переопределяет реализацию родительского класса, проверяя, существует ли ключ в коллекции и содержит ли он ненулевое значение.

__set() метод

public void __set(string $name, mixed $value)

public function __set($name,$value)
{
    $this->add($name,$value);
}

Устанавливает значение свойства компонента. Этот метод переопределяет реализацию родительского класса, добавляя новое значение ключа в коллекцию.

__unset() метод

public void __unset(string $name)

public function __unset($name)
{
    $this->remove($name);
}

Устанавливает свойство компонента в значение null. Этот метод переопределяет реализацию родительского класса, очищая указанное значение ключа.

add() метод

public void add(mixed $key, mixed $value)

public function add($key,$value)
{
    if($this->caseSensitive)
        parent::add($key,$value);
    else
        parent::add(strtolower($key),$value);
}

Добавляет элемент в карту. Это переопределяет реализацию родительского класса, сначала преобразуя ключ в нижний регистр, если caseSensitive имеет значение false.

canGetProperty() метод

public boolean canGetProperty(string $name)

public function canGetProperty($name)
{
    return $this->contains($name) || parent::canGetProperty($name);
}

Определяет, можно ли считать свойство. Этот метод переопределяет реализацию родительского класса, возвращая true, если коллекция содержит указанный ключ.

canSetProperty() метод

public boolean canSetProperty(string $name)

public function canSetProperty($name)
{
    return true;
}

Определяет, можно ли установить свойство. Этот метод переопределяет реализацию родительского класса, всегда возвращая true, так как вы всегда можете добавить новое значение в коллекцию.

contains() метод

public boolean contains(mixed $key)

public function contains($key)
{
    if($this->caseSensitive)
        return parent::contains($key);
    else
        return parent::contains(strtolower($key));
}

Возвращает, содержит ли указанный ключ элемент в карте. Это переопределяет реализацию родительского класса, сначала преобразуя ключ в нижний регистр, если caseSensitive равен false.

hasProperty() метод

public boolean hasProperty(string $name)

public function hasProperty($name)
{
    return $this->contains($name) || parent::hasProperty($name);
}

Определяет, определено ли свойство. Этот метод переопределяет реализацию родительского класса, возвращая true, если коллекция содержит указанный ключ.

itemAt() метод

public mixed itemAt(mixed $key)

public function itemAt($key)
{
    if($this->caseSensitive)
        return parent::itemAt($key);
    else
        return parent::itemAt(strtolower($key));
}

Возвращает элемент с указанным ключом. Это переопределяет реализацию родительского класса, сначала преобразуя ключ в нижний регистр, если caseSensitive равен false.

mergeWith() метод

public void mergeWith(mixed $data, boolean $recursive=true)

public function mergeWith($data,$recursive=true)
{
    if(!$this->caseSensitive && (is_array($data) || $data instanceof Traversable))
    {
        $d=array();
        foreach($data as $key=>$value)
            $d[strtolower($key)]=$value;
        return parent::mergeWith($d,$recursive);
    }
    parent::mergeWith($data,$recursive);
}

Объединяет данные из итерируемого объекта в карту.

Существующие элементы в карте будут перезаписаны, если их ключи совпадают с ключами источника. Если слияние рекурсивное, выполняется следующий алгоритм:

• данные карты сохраняются как $a, а данные источника — как $b;
• если у $a и $b есть элементы с одинаковыми строковыми ключами, эти массивы будут объединены с использованием данного алгоритма;
• любые целочисленные индексированные элементы в $b будут добавлены в $a и повторно проиндексированы соответственно;
• любые строковые индексированные элементы в $b будут перезаписывать элементы в $a с одинаковым индексом;

remove() метод

public mixed remove(mixed $key)

public function remove($key)
{
    if($this->caseSensitive)
        return parent::remove($key);
    else
        return parent::remove(strtolower($key));
}

Удаляет элемент из карты по его ключу. Это переопределяет реализацию родительского класса, сначала преобразуя ключ в нижний регистр, если caseSensitive равен false.