PHP | Ds\Set allocate()函数介绍

简介

allocate() 函数用于设置集合中元素的数量，不使用该函数也可以直接将元素添加到集合中。使用该函数可避免运行时重复分配内存，提高性能。

函数定义

public function allocate(int $capacity): void

参数

• $capacity：集合中元素的数量。

返回值

该函数没有返回值。

示例

<?php
$set = new \Ds\Set([1, 2, 3]);

// 设置集合容量为 4，避免运行时重复分配内存
$set->allocate(4);

// 添加元素到集合中
$set->add(4);
$set->add(5);

print_r($set);
?>

输出

Ds\Set Object
(
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    [4] => 5
)

注意事项

• 首次添加元素时，集合对象也会自动分配内存，因此 allocate() 函数使用必要性较低；
• 若设置的容量小于集合中已有元素的数量，集合会自动扩容，需要自行将容量调整为更大的值。