类 - QColl

集合对象的类型

保存对象的数组

指示迭代对象是否有效

构造函数

从数组创建一个集合

QColl::createFromArray() 方法从一个包含多个对象的数组创建集合。 新建的集合包含数组中的所有对象，并且确保对象的类型符合要求。

遍历集合中的所有对象，返回包含特定属性值的数组

$coll = new QColl('Post');
$coll[] = new Post(array('title' => 't1'));
$coll[] = new Post(array('title' => 't2'));
 
// 此时 $titles 中包含 t1 和 t2 两个值
$titles = $coll->values('title');

检查指定索引的对象是否存在，实现 ArrayAccess 接口

echo isset($coll[1]);

返回指定索引的对象，实现 ArrayAccess 接口

$item = $coll[1];

设置指定索引的对象，实现 ArrayAccess 接口

$coll[1] = $item;

注销指定索引的对象，实现 ArrayAccess 接口

unset($coll[1]);

Shift an element off the beginning of QColl

返回当前位置的对象，实现 Iterator 接口

返回遍历时的当前索引，实现 Iterator 接口

遍历下一个对象，实现 Iterator 接口

重置遍历索引，实现 Iterator 接口

判断是否是调用了 rewind() 或 next() 之后获得的有效对象，实现 Iterator 接口

返回对象总数，实现 Countable 接口

确定集合是否是空的

返回集合中的第一个对象，如果没有任何对象，则抛出异常

返回集合中的最后一个对象，如果没有任何对象，则抛出异常

追加数组或 QColl 对象的内容到集合中

$data = array(
    $item1,
    $item2,
    $item3
);
 
$coll->append($data);

QColl::append() 在追加数据时不会保持键名。

查找符合指定属性值的对象，没找到返回 NULL

// 在 $coll 集合中搜索 title 属性等于 T1 的第一个对象
$item = $coll->search('title', 'T1');

将集合所有元素的值转换为一个名值对数组

返回指定键的所有值

对集合中每一个对象调用指定的方法

class OrderItem
{
    public $price;
    public $quantity;
 
    function __construct($price, $quantity)
    {
        $this->price = $price;
        $this->quantity = $quantity;
    }
 
    // 计算订单项目的小计
    function sum()
    {
        return $this->price * $this->quantity;
    }
 
    // 返回单价
    function price()
    {
        return $this->price;
    }
 
    // 返回数量
    function quantity()
    {
        return $this->quantity;
    }
 
    // 累加多个合计
    static function totalSum($objects)
    {
        $total = 0;
        while (list(, $item) = each($objects))
        {
            $total += $item->sum();
        }
        return $total;
    }
 
    // 用于 QColl 的回调方法
    static function _qcoll_callback()
    {
        return array('sum' => 'totalSum');
    }
}
 
// 构造一个集合，包含多个 OrderItem 对象
$coll = QColl::create(array(
    new OrderItem(100, 3),
    new OrderItem(200, 5),
    new OrderItem(300, 2)), 'OrderItem');
 
// 取得集合中所有订单项目的金额合计
$sum = $coll->sum();
 
// 将会输出 1900 （根据 100 * 3 + 200 * 5 + 300 * 2 计算）
echo $sum;
 
// 取得每个项目的单价
$price = $coll->price();
// 将会输出 array(100, 200, 300)
dump($price);

当调用 QColl 自身没有定义的方法时，QColl 将认为开发者是要对集合中的每一个对象调用指定方法。

• 此时，QColl 首先检查集合中的对象是否提供了 _qcoll_callback() 静态方法；
• 如果有，则通过 _qcoll_callback() 取得一个方法映射表；
• QColl 根据 _qcoll_callback() 返回的方法映射表调用对象的其他静态方法。
• 如果没有提供 _qcoll_callback() 方法，或方法映射表中没有指定的方法。

  QColl 则遍历集合中的所有对象，尝试调用对象的指定方法。

检查值是否符合类型要求