Manuel PHP
Précédent |  | Suivant

# sesam_field_array

(PHP 3 CVS only)

sesam_field_array -- Retourne des informations sur une colonne

## Description

array sesam_field_array ( string result_id)

`result_id` is a valid result id returned by sesam_query().

sesam_field_array() retourne un tableau contenant les informations (nom de colonne, type, précision...) sur une colonne dans le résultat associé à `result_id`.

Tableau 1. Informations retournées par sesam_field_array()

Index | Contenu
--- | ---
int $arr["count"] | Nombre total de colonnes dans le résultat (ou zéro si la requête était immédiate). Les champs multiples de SESAM sont linéarisés, et traités comme autant de colonnes.
string $arr[col]["name"] | Le nom de la colonne `col`, avec `col` qui vaut entre 0 et `$arr["count"]-1`. La valeur retournée peut être une chaîne vide (pour les colonnes dynamiquement générées). Les champs multiples SESAM sont linéarisés, et traités comme autant de colonnes, avec le même nom.
string $arr[col]["count"] | L'attribut "count" décrit le facteur de répétition quand la colonne a été déclarée comme un champs multiple. Généralement, cet attribut est à 1. La première colonne d'un champs multiple contient le nombre de répétitions, tandis que les colonnes suivantes ont un facteur de répétition mis à 1. Ceci peut être utilisé pour detecter les champs multiples. Reportez vous à l'exemple de la fonction sesam_query() pour avoir un exemple d'utilisation.
string $arr[col]["type"] | Type de variable PHP pour les données de la colonne `col`, où `col` vaut de 0 à `$arr["count"]-1`. La valeur retournée peut être l'une de celles-ci : "integer" "double" "string" , suivant le type de données SQL. Les champs multiples SESAM sont linéarisés et traités comme autant de colonnes ayant le même type PHP.
string $arr[col]["sqltype"] | Type dedonnées SQL de la colonne `col`, où `col` vaut de 0 à `$arr["count"]-1`. La valeur retournée peut être l'une de celle-ci : "CHARACTER" "VARCHAR" "NUMERIC" "DECIMAL" "INTEGER" "SMALLINT" "FLOAT" "REAL" "DOUBLE" "DATE" "TIME" "TIMESTAMP" , décrivant le type de données SQL. Les champs multiples SESAM sont linéarisés et traités comme autant de colonnes du même type.
string $arr[col]["length"] | La taille de l'attribut, au sens SQL, de la colonne `col`, où `col` vaut de 0 à `$arr["count"]-1`. La longueur est utilisée avec les champs "CHARACTER" et "VARCHAR", pour spécifier la taille maximale de la colonne. Les champs multiples SESAM sont linéarisés et traités comme autant de colonnes ayant la même taille SQL.
string $arr[col]["precision"] | La précision de la colonne `col`, au sens SQL, où `col` vaut de 0 à `$arr["count"]-1`. La précision est utilisée avec les champs numériques et de date. Les champs multiples SESAM sont linéarisés et traités comme autant de colonnes ayant la même précision SQL.
string $arr[col]["scale"] | L'échelle de la colonne `col`, au sens SQL, où `col` vaut de 0 à `$arr["count"]-1`. L'échelle est utilisée avec les champs numériques. Les champs multiples SESAM sont linéarisés et traités comme autant de colonnes ayant la même échelle SQL.

Voir aussi sesam_query(), pour un exemple d'utilisation de sesam_field_array().

Précédent | Sommaire | Suivant
sesam_fetch_row | Niveau supérieur | sesam_field_name