# odbc_procedurecolumns

(PHP 4, PHP 5, PHP 7, PHP 8)

odbc_procedurecolumns — Liste les paramètres des procédures

### Description

odbc_procedurecolumns(
Odbc\Connection `$odbc`,
?string `$catalog` = `null`,
?string `$schema` = `null`,
?string `$procedure` = `null`,
?string `$column` = `null`
): Odbc\Result|false

Liste les paramètres des procédures.

### Liste de paramètres

`odbc`

  L'objet de connexion ODBC, voir la documentation de la fonction odbc_connect() pour plus de détails.

`catalog`

  Le catalogue ('calificatif' dans le jargon ODBC 2).

`schema`

  Le schéma ('propriétaire' dans le jargon ODBC 2). Ce paramètre accepte les masques de recherche suivants : `%` pour chercher zéro ou plusieurs caractères, et `_` pour chercher un seul caractère.

`procedure`

  Le procédure. Ce paramètre accepte les masques de recherche suivants : `%` pour chercher zéro ou plusieurs caractères, et `_` pour chercher un seul caractère.

`column`

  La colonne. Ce paramètre accepte les masques de recherche suivants : `%` pour chercher zéro ou plusieurs caractères, et `_` pour chercher un seul caractère.

### Valeurs de retour

Retourne les paramètres d'entrée et de sortie, ainsi que les colonnes utilisées dans les procédures désignées par les paramètres. Renvoie un objet de résultat ODBC ou `false` si une erreur survient.

Le jeu de résultat contient les colonnes suivantes :

- `PROCEDURE_CAT`
- `PROCEDURE_SCHEM`
- `PROCEDURE_NAME`
- `COLUMN_NAME`
- `COLUMN_TYPE`
- `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`

Les pilotes peuvent signaler des colonnes supplémentaires.

Le jeu de résultat est ordonné par `PROCEDURE_CAT`, `PROCEDURE_SCHEM`, `PROCEDURE_NAME` et `COLUMN_TYPE`.

### Historique

Version | Description
--- | ---
8.4.0 | `odbc` attend désormais une instance de Odbc\Connection; auparavant, un resource était attendu.
8.4.0 | Cette fonction retourne désormais une instance de Odbc\Result; auparavant, un resource était retourné.
8.0.0 | Prior to this version, the function could only be called with either one or five arguments.

### Exemples

Exemple #1 Liste les Colonnes d'une Procédure Stocké

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

Résultat de l'exemple ci-dessus est similaire à :

    Array
    (
        [PROCEDURE_CAT] => TutorialDB
        [PROCEDURE_SCHEM] => dbo
        [PROCEDURE_NAME] => GetEmployeeSalesYTD;1
        [COLUMN_NAME] => @SalesPerson
        [COLUMN_TYPE] => 1
        [DATA_TYPE] => -9
        [TYPE_NAME] => nvarchar
        [COLUMN_SIZE] => 50
        [BUFFER_LENGTH] => 100
        [DECIMAL_DIGITS] =>
        [NUM_PREC_RADIX] =>
        [NULLABLE] => 1
        [REMARKS] =>
        [COLUMN_DEF] =>
        [SQL_DATA_TYPE] => -9
        [SQL_DATETIME_SUB] =>
        [CHAR_OCTET_LENGTH] => 100
        [ORDINAL_POSITION] => 1
        [IS_NULLABLE] => YES
    )

### Voir aussi

- odbc_columns() - Liste les colonnes d'une table