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

array mysqli_fetch_lengths ( mysqli_result result )

Style orienté objet (méthode)

class mysqli_result {

array 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.

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/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("É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();

    
/* ffiche la longueur des colonnes */
    
foreach ($result->lengths as $i => $val) {
        
printf("Le champ %2d a une longueur de %2d\n", $i+1, $val);
    }
    
$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("É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);

    
/* Affiche la longueur des colonnes */
    
foreach (mysqli_fetch_lengths($result) as $i => $val) {
        
printf("Le champ %2d a un longueur de %2d\n", $i+1, $val);
    }
    
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