mysqli_fetch_lengths

(PHP 5)

mysqli_fetch_lengths

(no version information, might be only in CVS)

result->lengths --  Retourne la longueur des colonnes de la ligne courante du jeu de résultats

Description

Style procédural

mixed mysqli_fetch_lengths ( mysqli_result result )

Style orienté objet (méthode)

class mysqli_result {

mixed lengths

}

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. Un tableau indexé numériquement représentant la longueur de chaque colonne est retourné en cas de succès, FALSE en cas d'échec.

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/array/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", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    
printf("Echec 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();

    
/* Affiche la longueur des colonnes */
    
for ($i=0; $i < count($result->lengths); $i++) {
        
printf("Le champ %2d a une longueur de %2d\n", $i+1, $result->lengths[$i]);
    }
    
$result->close();
}

/* Fermeture de 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("Echec 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);

    
/* Affiche la longueur des colonnes */
    
$lengths = mysqli_fetch_lengths($result);
    for (
$i=0; $i < count($lengths); $i++) {
        
printf("Le champ %2d a un longueur de %2d\n", $i+1, $lengths[$i]);
    }
    
mysqli_free_result($result);
}

/* Fermeture de la connexion */
mysqli_close($link);
?>

L'exemple ci-dessus va afficher :

Le champ  1 a un longueur de  3
Le champ  2 a un longueur de  5
Le champ  3 a un longueur de 13
Le champ  4 a un longueur de  9
Le champ  5 a un longueur de  6
Le champ  6 a un longueur de  1
Le champ  7 a un longueur de  6
Le champ  8 a un longueur de  4
Le champ  9 a un longueur de  6
Le champ 10 a un longueur de  6
Le champ 11 a un longueur de  5
Le champ 12 a un longueur de 44
Le champ 13 a un longueur de  7
Le champ 14 a un longueur de  3
Le champ 15 a un longueur de  2