mysqli_result::fetch_assoc

mysqli_fetch_assoc

(PHP 5, PHP 7)

mysqli_result::fetch_assoc -- mysqli_fetch_assoc結果の行を連想配列で取得する

説明

オブジェクト指向型

public mysqli_result::fetch_assoc ( ) : array|null|false

手続き型

mysqli_fetch_assoc ( mysqli_result $result ) : array|null|false

取得した行に対応する連想配列を返します。もう行がない場合には null を返します。

注意: この関数により返されるフィー ルド名は 大文字小文字を区別 します。

注意: この関数は、 NULL フィールドに PHPの null 値を設定します。

パラメータ

result

手続き型のみ: mysqli_query()mysqli_store_result() あるいは mysqli_use_result() が返す結果セット ID。

返り値

取得した行に対応する値の連想配列を返します。 連想配列の各キーが、結果セットのカラムを表します。 結果セットにもう行がない場合には null を返します。

もし 2 つ以上のカラムが同じフィールド名であった場合は、最後に現れた カラムが優先され、以前のデータを上書きします。同名の複数のカラムに アクセスする場合、mysqli_fetch_row() を用いて 数値添字配列を使用するか、あるいはカラム名にエイリアスを指定する 必要があります。

例1 mysqli_result::fetch_assoc() の例

オブジェクト指向型

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost""my_user""my_password""world");

$query "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

$result $mysqli->query($query);

/* 連想配列を取得します */
while ($row $result->fetch_assoc()) {
    
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);
}

手続き型

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli mysqli_connect("localhost""my_user""my_password""world");

$query "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

$result mysqli_query($mysqli$query);

/* 連想配列を取得します */
while ($row mysqli_fetch_assoc($result)) {
    
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);
}

上の例の出力は、 たとえば以下のようになります。

Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

例2 mysqli_result, iterator, mysqli_result::fetch_assoc() の使い方の比較

mysqli_result は、foreach を使って繰り返し処理をすることができます。 結果セットは、現在の位置に関わらず、最初の行から処理されます。

<?php

mysqli_report
(MYSQLI_REPORT_ERROR MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost""my_user""my_password""world");

$query 'SELECT Name, CountryCode FROM City ORDER BY ID DESC';

// イテレータを使う場合
$result $mysqli->query($query);
foreach (
$result as $row) {
    
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);
}

echo 
"\n==================\n";

// イテレータを使わない場合
$result $mysqli->query($query);
while (
$row $result->fetch_assoc()) {
    
printf("%s (%s)\n"$row["Name"], $row["CountryCode"]);
}

上の例の出力は、 たとえば以下のようになります。

Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

==================
Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

参考