PDOStatement::getColumnMeta
(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.2.0)
PDOStatement::getColumnMeta — 결과 집합의 열에 대한 메타데이터를 반환합니다.
설명
public PDOStatement::getColumnMeta(int $column
): array|false
연관 배열로 결과 세트의 0 인덱스 열에 대한 메타데이터를 검색합니다.
경고 모든 PDO 드라이버가 PDOStatement::getColumnMeta()를 지원하는 것은 아닙니다.
다음 드라이버는 이 메서드를 지원합니다.
매개변수
column
- 결과 집합의 0-인덱싱된 열입니다.
반환 값
단일 열에 대한 메타데이터를 나타내는 다음 값을 포함하는 연관 배열을 반환합니다.
Column metadata
Name | Value |
---|---|
native_type |
열 값을 나타내는 데 사용되는 PHP 기본 유형입니다. |
driver:decl_type |
데이터베이스에서 열 값을 나타내는 데 사용되는 SQL 유형입니다. 결과 집합의 열이 함수의 결과이면 이 값은 PDOStatement::getColumnMeta()에서 반환되지 않습니다. |
flags |
이 열에 대해 설정된 모든 플래그입니다. |
name |
데이터베이스에서 반환된 이 열의 이름입니다. |
table |
데이터베이스에서 반환된 이 열의 테이블 이름입니다. |
len |
이 열의 길이입니다. 부동 소수점 십진수 이외의 유형의 경우 일반적으로 -1 입니다. |
precision |
이 열의 숫자 정밀도입니다. 부동 소수점 십진수 이외의 유형의 경우 일반적으로 0 입니다. |
pdo_type |
PDO::PARAM_* 상수로 표시되는 이 열의 유형입니다. |
요청한 열이 결과 집합에 없거나 결과 집합이 없으면 false
를 반환합니다.
Examples
예제 #1 열 메타데이터 검색
다음 예는 PDO_SQLITE 드라이버에서 함수(COUNT)에 의해 생성된 단일 열에 대한 메타데이터를 검색한 결과를 보여줍니다.
<?php
$select = $DB->query('SELECT COUNT(*) FROM fruit');
$meta = $select->getColumnMeta(0);
var_dump($meta);
?>
위의 예는 다음을 출력합니다.
array(6) { ["native_type"]=> string(7) "integer" ["flags"]=> array(0) { } ["name"]=> string(8) "COUNT(*)" ["len"]=> int(-1) ["precision"]=> int(0) ["pdo_type"]=> int(2) }
기타
- PDOStatement::columnCount() - 결과 집합의 열 수를 반환합니다.
- PDOStatement::rowCount() - 마지막 SQL 문의 영향을 받은 행 수를 반환합니다.