Ds\Set::capacity()
设置Set对象容量的限制
函数名称：Ds\Set::capacity()
适用版本：Ds扩展 v1.2.0 或更高版本
函数描述：设置Set对象容量的限制。容量限制是指Set对象可以容纳元素的最大数量。一旦达到容量限制，再次插入元素会抛出 OverflowException 异常。
用法：
$set = new Ds\Set();
// 设置Set对象的容量限制为10
$set->capacity(10);
参数：
capacity: 必需，表示要设置的容量限制，必须是大于等于0的整数值。
示例：
$set = new Ds\Set(['apple', 'banana', 'orange']);
// 设置Set对象的容量限制为3
$set->capacity(3);
$set->add('watermelon'); // 成功
$set->add('pineapple'); // 成功
try {
$set->add('grape'); // 抛出 OverflowException 异常
} catch (OverflowException $e) {
echo "Set已达到容量限制。";
}
以上示例中，首先创建了一个包含三个元素的Set对象。然后通过调用capacity方法，设置了Set对象的容量限制为3。接着可以看到，当尝试插入第4个元素时，由于Set对象已经达到容量限制，抛出了OverflowException异常。