mysqli_result::$current_field

mysqli_field_tell

(PHP 5, PHP 7, PHP 8)

mysqli_result::$current_field -- mysqli_field_tell — Récupère la position courante d'un champ dans un pointeur de résultat

Description

Style orienté objet

int $mysqli_result->current_field;

Style procédural

mysqli_field_tell(mysqli_result $result): int

Retourne la position du curseur de champ utilisé par le dernier appel à la fonction mysqli_fetch_field(). Cette valeur peut être utilisée comme argument de la fonction mysqli_field_seek().

Liste de paramètres

result: Style procédural uniquement : Un objet mysqli_result retourné par mysqli_query(), mysqli_store_result(), mysqli_use_result(), ou mysqli_stmt_get_result().

Valeurs de retour

Retourne la position courante du curseur de champ.

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 Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = $mysqli->query($query)) {

    /* Récupération des informations sur le champ pour toutes les colonnes */
    while ($finfo = $result->fetch_field()) {

        /* Récupération de la position du pointeur de champ */
        $currentfield = $result->current_field;

        printf("Colonne %d :\n", $currentfield);
        printf("Nom :     %s\n", $finfo->name);
        printf("Table :    %s\n", $finfo->table);
        printf("Longueur max. : %d\n", $finfo->max_length);
        printf("Drapeaux :    %d\n", $finfo->flags);
        printf("Type :     %d\n\n", $finfo->type);
    }
    $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 Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

if ($result = mysqli_query($link, $query)) {

    /* Récupération des informations sur le champ pour toutes les colonnes */
    while ($finfo = mysqli_fetch_field($result)) {

        /* Récupération de la position du pointeur de champ */
        $currentfield = mysqli_field_tell($result);

        printf("Colonne %d :\n", $currentfield);
        printf("Nom :     %s\n", $finfo->name);
        printf("Table :    %s\n", $finfo->table);
        printf("Longueur max. : %d\n", $finfo->max_length);
        printf("Drapeaux :    %d\n", $finfo->flags);
        printf("Type :     %d\n\n", $finfo->type);
    }
    mysqli_free_result($result);
}

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

Les exemples ci-dessus vont afficher :

Colonne 1:
Nom :           Name
Table :         Country
Longueur max. : 11
Drapeaux :      1
Type :          254

Colonne 2:
Nom :           SurfaceArea
Table      :    Country
Longueur max. : 10
Drapeaux :      32769
Type :          4

Voir aussi

mysqli_fetch_field() - Retourne le prochain champ dans le jeu de résultats
mysqli_field_seek() - Déplace le pointeur de résultat sur le champ spécifié