SplFixedArray::setSize

配列のサイズを変更する

説明

public bool SplFixedArray::setSize(int $size)

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

パラメータ

size

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

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

size が負の数である場合に InvalidArgumentException をスローします。

size を数値として解釈できない場合に E_WARNING が発生します。

例1 SplFixedArray::setSize の例

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

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

5
10