====== getCol ======
~~NOTOC~~
<WRAP right box>
== syntax ==
   mixed getCol {
         mixed $sql
         optional string[] $bindvars
         optional bool $trimString
         }
</WRAP>

===== Description =====
The function executes a statement and returns the first column of each row of the the entire recordset in an array or false if the statement execution fails. If no records match the provided SQL statement, an empty array is returned.

The presentation of the returned data can be modified by:  
  * [[v5:reference:adodb_fetch_mode|$ADODB_FETCH_MODE]] variable,
  * [[v5:reference:adodb_assoc_case|ADODB_ASSOC_CASE]] constant,
  * [[v5:reference:connection:setfetchmode|setFetchMode()]] function.


For a detailed description of the SQL and bind parameters passed, see [[v5:reference:connection:execute|execute()]].

The optional third parameter passed enables space trimming of the returned value. This is only relevant if the returned string is coming from a CHAR type field.

==== Usage ====
<code php>
/*
 * DB2 Connection assumed
*/
$ar = $db->getCol("SELECT * FROM ACT");

/*
 * $ar returns:
Array
(
    [0] => 10
    [1] => 20
    [2] => 30

.......
*/
            
</code>