SplFixedArray クラス

(PHP 5 >= 5.3.0, PHP 7)

はじめに

SplFixedArray クラスは配列の主要な機能を提供します。 SplFixedArray と通常の PHP の配列との主な違いは、 SplFixedArray は固定長であって、整数値で指定した範囲内の添字しか使用できないところです。これにより、より高速な配列の実装が可能となりました。

クラス概要

SplFixedArray implements Iterator , ArrayAccess , Countable {

/* メソッド */

public __construct ([ int $size = 0 ] )

public int count ( void )

public mixed current ( void )

public static SplFixedArray fromArray ( array $array [, bool $save_indexes = true ] )

public int getSize ( void )

public int key ( void )

public void next ( void )

public bool offsetExists ( int $index )

public mixed offsetGet ( int $index )

public void offsetSet ( int $index , mixed $newval )

public void offsetUnset ( int $index )

public void rewind ( void )

public bool setSize ( int $size )

public array toArray ( void )

public bool valid ( void )

public void __wakeup ( void )

}

例

例1 SplFixedArray の使用例


<?php
// 固定長の配列を初期化します
$array = new SplFixedArray(5);

$array[1] = 2;
$array[4] = "foo";

var_dump($array[0]); // NULL
var_dump($array[1]); // int(2)

var_dump($array["4"]); // string(3) "foo"

// 配列のサイズを 10 に拡大します
$array->setSize(10);

$array[9] = "asdf";

// 配列のサイズを 2 に縮めます
$array->setSize(2);

// 以下は RuntimeException: Index invalid or out of range となります
try {
    var_dump($array["non-numeric"]);
} catch(RuntimeException $re) {
    echo "RuntimeException: ".$re->getMessage()."\n";
}

try {
    var_dump($array[-1]);
} catch(RuntimeException $re) {
    echo "RuntimeException: ".$re->getMessage()."\n";
}

try {
    var_dump($array[5]);
} catch(RuntimeException $re) {
    echo "RuntimeException: ".$re->getMessage()."\n";
}
?>

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

NULL
int(2)
string(3) "foo"
RuntimeException: Index invalid or out of range
RuntimeException: Index invalid or out of range
RuntimeException: Index invalid or out of range

SplFixedArray::__construct ? 新しい固定長配列を作成する
SplFixedArray::count ? 配列のサイズを返す
SplFixedArray::current ? 現在の配列の要素を返す
SplFixedArray::fromArray ? PHP の配列を SplFixedArray インスタンスにインポートする
SplFixedArray::getSize ? 配列のサイズを取得する
SplFixedArray::key ? 現在の配列の添字を返す
SplFixedArray::next ? 次のエントリに進む
SplFixedArray::offsetExists ? 指定した添字が存在するかどうかを返す
SplFixedArray::offsetGet ? 指定した添字の値を返す
SplFixedArray::offsetSet ? 指定した添字の新しい値を設定する
SplFixedArray::offsetUnset ? 指定した添字の値を消去する
SplFixedArray::rewind ? イテレータを先頭に巻き戻す
SplFixedArray::setSize ? 配列のサイズを変更する
SplFixedArray::toArray ? 固定長配列から PHP の配列を返す
SplFixedArray::valid ? 配列にまだ要素があるかどうかを調べる
SplFixedArray::__wakeup ? アンシリアライズ後に配列を再初期化する

各種マニュアル： PHPマニュアル \| PEARマニュアル \| Smarty(英語)マニュアル \| PHP-GTKマニュアル \| 「SplFixedArray クラス」をGoogle検索
copyright © 1997-2024 PHP ドキュメント作成グループ(ライセンス). provided by php spot.	マニュアル：

SplFixedArray クラス

はじめに

クラス概要

例

目次