Ds\Set::capacity()函式—用法及示例

函式名稱：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異常。