mysqli_result::fetch_array

(PHP 5, PHP 7, PHP 8)

mysqli_result::fetch_array -- mysqli_fetch_array — 결과 집합의 다음 행을 연관, 숫자 배열 또는 둘 다로 가져옵니다.


설명

객체 지향 스타일

public mysqli_result::fetch_array(int $mode = MYSQLI_BOTH): array|null|false

절차적 스타일

mysqli_fetch_array(mysqli_result $result, int $mode = MYSQLI_BOTH): array|null|false

결과 집합에서 데이터의 한 행을 가져와 배열로 반환합니다. 이 함수에 대한 각 후속 호출은 결과 집합 내에서 다음 행을 반환하거나 더 이상 행이 없으면 null을 반환합니다.

결과 배열의 숫자 인덱스에 데이터를 저장하는 것 외에도 이 함수는 결과 집합의 필드 이름을 키로 사용하여 연관 인덱스에 데이터를 저장할 수도 있습니다.

결과의 두 개 이상의 열이 동일한 이름을 갖는 경우 마지막 열이 우선적으로 적용되고 이전 데이터를 덮어씁니다. 동일한 이름을 가진 여러 열에 액세스하려면 행의 숫자로 인덱싱된 버전을 사용해야 합니다.

참고: 이 함수가 반환하는 필드 이름은 대소문자를 구분합니다.

참고: 이 함수는 NULL 필드를 PHP null 값으로 설정합니다.


매개변수

result
절차적 스타일 전용: mysqli_query(), mysqli_store_result(), mysqli_use_result() 또는 mysqli_stmt_get_result()에 의해 반환된 mysqli_result 객체.
mode
이 선택적 매개변수는 현재 행 데이터에서 생성되어야 하는 배열 유형을 나타내는 상수입니다. 이 매개변수에 가능한 값은 MYSQLI_ASSOC, MYSQLI_NUM 또는 MYSQLI_BOTH 상수입니다.

MYSQLI_ASSOC 상수를 사용함으로써 이 함수는 mysqli_fetch_assoc()과 동일하게 작동하는 반면 MYSQLI_NUMmysqli_fetch_row() 함수와 동일하게 작동합니다. 마지막 옵션 MYSQLI_BOTH는 둘 다의 속성을 가진 단일 배열을 생성합니다.


반환 값

가져온 행을 나타내는 배열을 반환하고 결과 집합에 더 이상 행이 없으면 null을 반환하고 실패하면 false를 반환합니다.


Examples

예제 #1 mysqli_result::fetch_array() 예제

객체 지향 스타일

                  
<?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 LIMIT 3";
$result = $mysqli->query($query);

/* numeric array */
$row = $result->fetch_array(MYSQLI_NUM);
printf("%s (%s)\n", $row[0], $row[1]);

/* associative array */
$row = $result->fetch_array(MYSQLI_ASSOC);
printf("%s (%s)\n", $row["Name"], $row["CountryCode"]);

/* associative and numeric array */
$row = $result->fetch_array(MYSQLI_BOTH);
printf("%s (%s)\n", $row[0], $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 LIMIT 3";
$result = mysqli_query($mysqli, $query);

/* numeric array */
$row = mysqli_fetch_array($result, MYSQLI_NUM);
printf("%s (%s)\n", $row[0], $row[1]);

/* associative array */
$row = mysqli_fetch_array($result, MYSQLI_ASSOC);
printf("%s (%s)\n", $row["Name"], $row["CountryCode"]);

/* associative and numeric array */
$row = mysqli_fetch_array($result, MYSQLI_BOTH);
printf("%s (%s)\n", $row[0], $row["CountryCode"]);
                  
                

위의 예는 다음과 유사한 결과를 출력합니다.

Kabul (AFG)
Qandahar (AFG)
Herat (AFG)
                

기타