sesam_field

Manuel PHP
Précédent		Suivant

Description

array sesam_field_array ( string result_id )

result_id est un identifiant de résultat valide retourné par la fonction 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 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 : "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 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(), pour un exemple d'utilisation de sesam_field_array().

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