PDO문::columnCount

PDOStatement::columnCount — 결과 집합의 열 수를 반환합니다. (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)

설명하다

문법

 int PDOStatement::columnCount( void )

PDOStatement::columnCount()를 사용하여 PDOStatement 개체가 나타내는 결과 집합의 열 수를 반환합니다.

PDO::query()에서 반환된 PDOStatement 개체의 경우 열 개수 계산을 즉시 사용할 수 있습니다.

PDO::prepare()에서 반환된 PDOStatement 객체인 경우 PDOStatement::execute()가 호출될 때까지 열 수를 정확하게 계산할 수 없습니다.

반환 값

PDOStatement 개체가 나타내는 결과 집합의 열 수를 반환합니다. 결과 세트가 없으면 PDOStatement::columnCount()는 0을 반환합니다.

예

열 수 계산

다음 예에서는 PDOStatement::columnCount()를 사용하여 결과 집합 및 빈 집합에 대해 작업하는 방법을 보여줍니다.

 <?php$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');$sth = $dbh->prepare("SELECT name, color FROM Fruit");/* 하나를 계산합니다(하지 않음 존재합니다) 결과 집합의 열 수*/$colcount = $sth->columnCount();print("execute() 전에 결과 집합에는 $colcount 열이 있습니다( be 0)n");$sth->execute();/* 결과 집합의 열 수 계산*/$colcount = $sth->columnCount();print("execute() 후 결과 집합 $colcount 열이 있습니다(2개여야 함)n");?>

위 루틴은 다음을 출력합니다:

 Execute() 이전에는 결과 집합에 0개의 열이 있습니다(0이어야 합니다).execute() 이후에는 결과 집합에 2개의 열이 있습니다(2여야 합니다).