SplFixedArray::setSize

配列のサイズを変更する

説明

public true SplFixedArray::setSize(int $size)

配列のサイズを、新しい値 size に変更します。 size が現在の配列のサイズより小さい場合は、 入りきらなかったそれ以降の値は破棄されます。 size が現在の配列のサイズより大きい場合は、 増えた要素の値は null となります。

パラメータ

size

新しい配列のサイズ。 0 から PHP_INT_MAX までの数を指定します。

戻り値

常に true を返します。

エラー / 例外

size が0未満の場合、 ValueError をスローします。

変更履歴

バージョン 説明
8.4.0 SplFixedArray::setSize の 仮の戻り値の型が、true になりました。

例1 SplFixedArray::setSize の例

<?php
   $array = new SplFixedArray(5);
   echo $array->getSize()."\n";
   $array->setSize(10);
   echo $array->getSize()."\n";
?>

上の例の出力は以下となります。

5
10