odbc_columns

Lists the column names in specified tables

&reftitle.description; ``resource``false```odbc_columns` `resource` `odbc` ``string``null```catalog`&null; ``string``null```schema`&null; ``string``null```table`&null; ``string``null```column`&null;

Lists all columns in the requested range.

&reftitle.parameters;

`odbc`

- &odbc.connection.id;

`catalog`

- &odbc.parameter.catalog;

`schema`

- &odbc.parameter.schema; &odbc.parameter.search;

`table`

- The table name. &odbc.parameter.search;

`column`

- The column name. &odbc.parameter.search;

&reftitle.returnvalues;

Returns an ODBC result identifier&return.falseforfailure;.

The result set has the following columns:

- `TABLE_CAT`

- `TABLE_SCHEM`

- `TABLE_NAME`

- `COLUMN_NAME`

- `DATA_TYPE`

- `TYPE_NAME`

- `COLUMN_SIZE`

- `BUFFER_LENGTH`

- `DECIMAL_DIGITS`

- `NUM_PREC_RADIX`

- `NULLABLE`

- `REMARKS`

- `COLUMN_DEF`

- `SQL_DATA_TYPE`

- `SQL_DATETIME_SUB`

- `CHAR_OCTET_LENGTH`

- `ORDINAL_POSITION`

- `IS_NULLABLE`

&odbc.result.driver-specific;

The result set is ordered by `TABLE_CAT`, `TABLE_SCHEM`, `TABLE_NAME` and `ORDINAL_POSITION`.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | `schema`, `table` and `column` are now nullable.

&reftitle.examples;

### List Columns of a Table

    <?php
    $conn = odbc_connect($dsn, $user, $pass);
    $columns = odbc_columns($conn, 'TutorialDB', 'dbo', 'test', '%');
    while (($row = odbc_fetch_array($columns))) {
        print_r($row);
        break; // further rows omitted for brevity
    }
    ?>

&example.outputs.similar;

    Array
    (
        [TABLE_CAT] => TutorialDB
        [TABLE_SCHEM] => dbo
        [TABLE_NAME] => TEST
        [COLUMN_NAME] => id
        [DATA_TYPE] => 4
        [TYPE_NAME] => int
        [COLUMN_SIZE] => 10
        [BUFFER_LENGTH] => 4
        [DECIMAL_DIGITS] => 0
        [NUM_PREC_RADIX] => 10
        [NULLABLE] => 0
        [REMARKS] =>
        [COLUMN_DEF] =>
        [SQL_DATA_TYPE] => 4
        [SQL_DATETIME_SUB] =>
        [CHAR_OCTET_LENGTH] =>
        [ORDINAL_POSITION] => 1
        [IS_NULLABLE] => NO
    )

&reftitle.seealso;

- `odbc_columnprivileges`
- `odbc_procedurecolumns`