↑HOME

《 PR DOCUMENT 》1963

mysql_data_seek 内部的な結果ポインタを移動する


(PHP 4, PHP 5)


説明

bool mysql_data_seek ( resource $result , int $row_number )

mysql_data_seek() は、指定した結果 ID (result_identifier)が指す MySQL 結果の内部ポインタが指定した行番号 (row_number)を指すように移動します。 この後、たとえば mysql_fetch_assoc() のような MySQL のフェッチ関数をコールした場合には、 ここで指定した行の内容が返されます。

row_number は 0 から始まります。 row_number は 0 から mysql_num_rows() - 1 までの範囲にあるべきです。 しかし、もし結果セットが空(mysql_num_rows() == 0) の場合、0 へのシークは E_WARNING を発生して失敗し、mysql_data_seek() は FALSE を返します。

パラメータ

result

    評価された結果 リソース。この結果は、mysql_query() のコールにより得られたものです。

row_number

    新しく結果ポインタを設定したい行番号です。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。



例1 mysql_data_seek() の例

<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
    die('接続できませんでした: ' . mysql_error());
}
$db_selected = mysql_select_db('sample_db');
if (!$db_selected) {
    die('データベースを選択できませんでした: ' . mysql_error());
}
$query = 'SELECT last_name, first_name FROM friends';
$result = mysql_query($query);
if (!$result) {
    die('クエリは失敗しました: ' . mysql_error());
}
/* 行を逆順で取得する */
for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
    if (!mysql_data_seek($result, $i)) {
        echo "行 $i をシークできません: " . mysql_error() . "\n";
        continue;
    }

    if (!($row = mysql_fetch_assoc($result))) {
        continue;
    }

    echo $row['last_name'] . ' ' . $row['first_name'] . "<br />\n";
}

mysql_free_result($result);
?>

注意

    注意:

    mysql_data_seek() は、 mysql_query() との組み合わせでのみ利用可能です。 mysql_unbuffered_query() と組み合わせることはできません。

参考

    * mysql_query() - MySQL クエリを送信する
    * mysql_num_rows() - 結果における行の数を得る
    * mysql_fetch_row() - 結果を添字配列として取得する
    * mysql_fetch_assoc() - 連想配列として結果の行を取得する
    * mysql_fetch_array() - 連想配列、添字配列、またはその両方として結果の行を取得する
    * mysql_fetch_object() - 結果の行をオブジェクトとして取得する



■MySQL管理ツール

phpMyAdmin

phpMyAdmin(ピーエイチピーマイアドミン)はMySQLをインターネット越しに管理するためのデータベース接続クライアントツールで、PHPで実装されている。 phpMyAdminを用いることで、SQL文を記述することなく、MySQLのデータベースに対して様々な操作が行える。 また、ユーザが任意のSQL文を記述して実行することもできる。



ポップでコミカルなフォント「Toeris」と力強いBlackletterフォント「Memela Fraktur」過去ログ一覧WEBシステム開発 Perl CGIスクリプト プログラム AnyDBM_File

  ↑HOME