PDOStatement::columnCount — ส่งกลับจำนวนคอลัมน์ในชุดผลลัพธ์ (PHP 5 >= 5.1.0, PECL pdo >= 0.2.0)
int PDOStatement::columnCount ( โมฆะ )
ใช้ PDOStatement::columnCount() เพื่อส่งคืนจำนวนคอลัมน์ในชุดผลลัพธ์ที่แสดงโดยวัตถุ PDOStatement
ในกรณีของวัตถุ PDOStatement ที่ส่งคืนโดย PDO::query() การคำนวณจำนวนคอลัมน์จะพร้อมใช้งานทันที
หากเป็นวัตถุ PDOStatement ที่ส่งคืนโดย PDO::prepare() จำนวนคอลัมน์จะไม่สามารถคำนวณได้อย่างถูกต้องจนกว่าจะมีการเรียก PDOStatement::execute()
ส่งกลับจำนวนคอลัมน์ในชุดผลลัพธ์ที่แสดงโดยวัตถุ PDOStatement หากไม่มีการตั้งค่าผลลัพธ์ PDOStatement::columnCount() จะส่งกลับ 0
ตัวอย่างต่อไปนี้สาธิตวิธีการใช้ PDOStatement::columnCount() เพื่อดำเนินการกับชุดผลลัพธ์และชุดว่าง
<?php$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');$sth = $dbh->prepare("เลือกชื่อ, สีจากผลไม้");/* คำนวณอย่างใดอย่างหนึ่ง (ไม่ มีอยู่ )จำนวนคอลัมน์ในชุดผลลัพธ์*/$colcount = $sth->columnCount();print("BeforeExecute() ชุดผลลัพธ์มีคอลัมน์ $colcount (ควร เป็น 0)n");$sth->execute();/* คำนวณจำนวนคอลัมน์ในชุดผลลัพธ์*/$colcount = $sth->columnCount();print("After ดำเนินการ(), ชุดผลลัพธ์ มีคอลัมน์ $colcount (ควรเป็น 2)n");?>
รูทีนข้างต้นจะส่งออก:
ก่อนดำเนินการ () ชุดผลลัพธ์จะมี 0 คอลัมน์ (ควรเป็น 0) หลังจากดำเนินการ () ชุดผลลัพธ์จะมี 2 คอลัมน์ (ควรเป็น 2)