Précédent   CXLVII. SESAM  Suivant

sesam_field_array

(No version information available, might be only in CVS)

sesam_field_array — Retourne des informations sur une colonne de résultat

Description

array sesam_field_array ( string $result_id )

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

Liste de paramètres

result_id

Un identifiant de résultat valide, retourné par la fonction sesam_query() .

Valeurs de retour

Tableau 286.  Informations retournées par sesam_field_array()

Élément du tableau 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 champ multiple. Généralement, cet attribut est à 1. La première colonne d'un champ 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 :
, 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 de données SQL de la colonne col , où col vaut de 0 à $arr["count"]-1 . La valeur retournée peut être l'une de celles-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()

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