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("قبل التنفيذ ()، تحتوي مجموعة النتائج على أعمدة $colcount (يجب أن تكون be 0)n");$sth->execute();/* احسب عدد الأعمدة في مجموعة النتائج*/$colcount = $sth->columnCount();print("بعد التنفيذ ()، مجموعة النتائج يحتوي على أعمدة $colcount (يجب أن تكون 2)n");?>سوف يخرج الروتين أعلاه:
قبل التنفيذ ()، تحتوي مجموعة النتائج على 0 عمود (يجب أن تكون 0) بعد التنفيذ ()، تحتوي مجموعة النتائج على عمودين (يجب أن تكون 2)