odbc_specialcolumns

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

odbc_specialcolumns — Retourne l'ensemble optimal de colonnes

Description

function 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'une 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ées 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

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug
＋add a note

User Contributed Notes

There are no user contributed notes for this page.