mysqli_stmt::result_metadata

(PHP 5, PHP 7, PHP 8)

mysqli_stmt::result_metadata -- mysqli_stmt_result_metadata - 준비된 명령문에서 결과 집합 메타데이터를 반환합니다.


설명

객체 지향 스타일

public mysqli_stmt::result_metadata(): mysqli_result|false

절차적 스타일

mysqli_stmt_result_metadata(mysqli_stmt $statement): mysqli_result|false

mysqli_prepare()에 전달된 명령문이 결과 세트를 생성하는 명령문인 경우 mysqli_stmt_result_metadata()는 총 필드 수 및 개별 필드 정보와 같은 메타 정보를 처리하는 데 사용할 수 있는 결과 객체를 리턴합니다.

메모:

이 결과 집합 포인터는 다음과 같이 결과 집합 메타데이터를 처리하는 필드 기반 함수에 인수로 전달할 수 있습니다.

결과 집합 구조는 작업이 완료되면 해제되어야 합니다. 이는 mysqli_free_result()에 전달하여 수행할 수 있습니다.

메모: mysqli_stmt_result_metadata()에 의해 반환된 결과 집합에는 메타데이터만 포함됩니다. 행 결과가 포함되어 있지 않습니다. 행은 mysqli_stmt_fetch()와 함께 명령문 핸들을 사용하여 얻습니다.


매개변수

statement
절차적 스타일 전용: mysqli_stmt_init()에 의해 반환된 mysqli_stmt 객체.

반환 값

결과 개체를 반환하거나 오류가 발생한 경우 false를 반환합니다.


Examples

예제 #1 객체 지향 스타일

                  
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "test");

$mysqli->query("DROP TABLE IF EXISTS friends");
$mysqli->query("CREATE TABLE friends (id int, name varchar(20))");

$mysqli->query("INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

$stmt = $mysqli->prepare("SELECT id, name FROM friends");
$stmt->execute();

/* get resultset for metadata */
$result = $stmt->result_metadata();

/* retrieve field information from metadata result set */
$field = $result->fetch_field();

printf("Fieldname: %s\n", $field->name);

/* close resultset */
$result->close();

/* close connection */
$mysqli->close();
?>
                  
                

예제 #2 절차적 스타일

                  
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "test");

mysqli_query($link, "DROP TABLE IF EXISTS friends");
mysqli_query($link, "CREATE TABLE friends (id int, name varchar(20))");

mysqli_query($link, "INSERT INTO friends VALUES (1,'Hartmut'), (2, 'Ulf')");

$stmt = mysqli_prepare($link, "SELECT id, name FROM friends");
mysqli_stmt_execute($stmt);

/* get resultset for metadata */
$result = mysqli_stmt_result_metadata($stmt);

/* retrieve field information from metadata result set */
$field = mysqli_fetch_field($result);

printf("Fieldname: %s\n", $field->name);

/* close resultset */
mysqli_free_result($result);

/* close connection */
mysqli_close($link);
?>
                  
                

기타