MySQLi_Result
PHP Manual

mysqli_result->lengths

mysqli_fetch_lengths

(PHP 5)

mysqli_result->lengths -- mysqli_fetch_lengthsRetourne la longueur des colonnes de la ligne courante du jeu de résultats

Description

Style orienté objet (propriétés) :

mysqli_result
array $lengths;

Style procédural :

array mysqli_fetch_lengths ( mysqli_result $result )

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);
?>

L'exemple ci-dessus va 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

MySQLi_Result
PHP Manual