SplFixedArray::setSize

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

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

関連キーワード:  配列, サイズ, 変更, SplFixedArray, size, setSize, エラー, 発生, 解釈, 数値