mysqli_result::$lengths
mysqli_fetch_lengths
(PHP 5)
mysqli_result::$lengths -- mysqli_fetch_lengths — Retourne la longueur des colonnes de la ligne courante du jeu de résultats
Description
Style orienté objet
Style procédural
La fonction mysqli_fetch_lengths() retourne un tableau
contenant la longueur de chaque colonne de la ligne courante du jeu de
résultats représenté par le paramètre result.
Liste de paramètres
-
result -
Style procédural uniquement : Un identifiant de jeu de résultats retourné par la fonction mysqli_query(), mysqli_store_result() ou mysqli_use_result().
Valeurs de retour
Un tableau d'entiers représentant la taille de chaque colonne (n'incluant
aucun caractère null de fin). Retourne FALSE si une erreur survient.
mysqli_fetch_lengths() n'est valide que pour la ligne courant du
jeu de résultats. Elle retourne FALSE si vous l'appelez avant les fonctions
mysqli_fetch_row(), mysqli_fetch_array(),
mysqli_fetch_object()
ou après avoir récupéré toutes les lignes du résultat.
Exemples
Exemple #1 Style orienté objet
<?php
$mysqli = new mysqli("localhost", "mon_user", "mon_mot_de_passe", "la_base");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT * from Country ORDER BY Code LIMIT 1";
if ($result = $mysqli->query($query)) {
$row = $result->fetch_row();
/* Affichage de la longueur des colonnes */
foreach ($result->lengths as $i => $val) {
printf("Le champ n°%2d a une longueur de %2d\n", $i+1, $val);
}
$result->close();
}
/* Ferme la connexion */
$mysqli->close();
?>Exemple #2 Style procédural
<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Échec de la connexion : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT * from Country ORDER BY Code LIMIT 1"; if ($result = mysqli_query($link, $query)) { $row = mysqli_fetch_row($result); /* Affichage de la longueur des colonnes */ foreach (mysqli_fetch_lengths($result) as $i => $val) { printf("Le champ n°%2d a une longueur de %2d\n", $i+1, $val); } mysqli_free_result($result); } /* Ferme la connexion */ mysqli_close($link); ?>
Les exemples ci-dessus vont afficher :
Le champ n° 1 a une longueur de 3 Le champ n° 2 a une longueur de 5 Le champ n° 3 a une longueur de 13 Le champ n° 4 a une longueur de 9 Le champ n° 5 a une longueur de 6 Le champ n° 6 a une longueur de 1 Le champ n° 7 a une longueur de 6 Le champ n° 8 a une longueur de 4 Le champ n° 9 a une longueur de 6 Le champ n°10 a une longueur de 6 Le champ n°11 a une longueur de 5 Le champ n°12 a une longueur de 44 Le champ n°13 a une longueur de 7 Le champ n°14 a une longueur de 3 Le champ n°15 a une longueur de 2
