px_retrieve_record
(PECL paradox >= 1.4.0)
px_retrieve_record — paradox データベースのレコードを返す
説明
$pxdoc
, int $num
[, int $mode = 0
] )この関数は px_get_record() と非常によく似ていますが、 関数内でデータを取得するために使用している方法が違います。 この関数は、各フィールドの値を取得するのに pxlib の機能を使用しており、 結果としてより多くのフィールド型をサポートしています。
注意:
この関数は、pxlib >= 0.6.0 が使用されている場合にのみ有効です。
パラメータ
-
pxdoc -
px_new() が返す、 paradox データベースのリソース ID。
-
num -
レコード番号は人為的な番号で、レコードがデータベースに格納された順番を表します。 最初のレコードの番号は 0 です。
-
mode -
キーを小文字または大文字に変換するために、 オプションの
modeにPX_KEYTOLOWERあるいはPX_KEYTOUPPERを指定することができます。modeが渡されなかったりあるいは 0 であった場合は、 キーはフィールド名そのものとなります。 要素の値にはフィールドの値が含まれます。 NULL 値もそのまま残ります。NULL は 0.0、0 あるいは 空の文字列とはことなる値です。PX_FIELD_TIME型のフィールドは、深夜 0 時から数えたミリ秒数を整数で返します。 timestamp は浮動小数点値で、ユリウス暦の開始時からの経過ミリ秒数を返します。
返り値
paradox データベースから、num 番目のレコードを返します。
レコードは連想配列形式で返され、フィールド名がキーとなります。
忘却曲線を使ってこの関数を確実に記憶に残す
