mysqli_fetch_lengths

(PHP 5)

mysqli_fetch_lengths

(no version information, might be only in CVS)

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

Description

Style procédural

mixed mysqli_fetch_lengths ( object result)

Style orienté objet (méthode)

class result {

mixed lengths

}

La fonction mysqli_fetch_lengths() retourne un tableau contenant les longueurs 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 jeux de résultats. Elle retourne FALSE si vous l'appelez avant d'appeler 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 champs %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 champs  1 a un longueur de  3
Le champs  2 a un longueur de  5
Le champs  3 a un longueur de 13
Le champs  4 a un longueur de  9
Le champs  5 a un longueur de  6
Le champs  6 a un longueur de  1
Le champs  7 a un longueur de  6
Le champs  8 a un longueur de  4
Le champs  9 a un longueur de  6
Le champs 10 a un longueur de  6
Le champs 11 a un longueur de  5
Le champs 12 a un longueur de 44
Le champs 13 a un longueur de  7
Le champs 14 a un longueur de  3
Le champs 15 a un longueur de  2