SplFixedArray::setSize

(PHP 5 >= 5.3.0, PHP 7)

SplFixedArray::setSize — 配列のサイズを変更する

説明

public SplFixedArray::setSize ( int $size ) : bool

配列のサイズを、新しい値 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