# odbc_specialcolumns

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

odbc_specialcolumns — Retourne l'ensemble optimal de colonnes

### Description

odbc_specialcolumns(
Odbc\Connection `$odbc`,
int `$type`,
?string `$catalog`,
string `$schema`,
string `$table`,
int `$scope`,
int `$nullable`
): Odbc\Result|false

Retourne soit l'ensemble optimal de colonnes qui identifie de façon unique une ligne d'une table, ou les colonnes qui sont automatiquement mises à jour lorsqu'un des valeurs de la ligne est mise à jour par une transaction.

### Liste de paramètres

`odbc`

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

`type`
  Lorsque le type est `SQL_BEST_ROWID`, odbc_specialcolumns() retourne la ou les colonnes qui permettent de repérer uniquement chaque ligne d'une table. Lorsque le type est `SQL_ROWVER`, odbc_specialcolumns() retourne la colonne ou les colonnes de la table spécifiée, s'il y en a, elles sont automatiquement mises à jour par les données sources lorsque chaque valeur de la ligne est mise à jour par n'importe quelle transaction.
`catalog`

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

`schema`

  Le schéma ('propriétaire' dans le jargon ODBC 2).

`table`

  La table.

`scope`

  Le `scope`, qui ordonne le jeu de résultats. Un de `SQL_SCOPE_CURROW`, `SQL_SCOPE_TRANSACTION` ou `SQL_SCOPE_SESSION`.

`nullable`

  Détermine si les colonnes spéciales qui peuvent avoir une valeur NULL doivent être retourné ou non. Un de `SQL_NO_NULLS` ou `SQL_NULLABLE`.

### Valeurs de retour

Renvoie un objet de résultat ODBC ou `false` si une erreur survient.

Le jeu de résultat contient les colonnes suivantes :

- `SCOPE`
- `COLUMN_NAME`
- `DATA_TYPE`
- `TYPE_NAME`
- `COLUMN_SIZE`
- `BUFFER_LENGTH`
- `DECIMAL_DIGITS`
- `PSEUDO_COLUMN`

Les pilotes peuvent signaler des colonnes supplémentaires.

Le jeu de résultat est ordonné par `SCOPE`.

### 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é.

### Voir aussi

- odbc_tables() - Liste les tables d'une source