Desplaza el puntero de resultado al campo especificado

# mysqli_result::field_seek

# mysqli_field_seek

(PHP 5, PHP 7, PHP 8)

mysqli_result::field_seek -- mysqli_field_seek — Desplaza el puntero de resultado al campo especificado

### Descripción

Estilo orientado a objetos

public function mysqli_result::field_seek(int `$index`): true

Estilo procedimental

function mysqli_field_seek(mysqli_result `$result`, int `$index`): true

Coloca el cursor en el campo especificado por el número `index`. La próxima llamada a la función mysqli_fetch_field() devolverá la definición del campo de la columna asociada a esta posición.

> Nota:

> Para moverse al inicio de una fila, pase una posición con valor cero.

### Parámetros

`result`
  Solo estilo procedimental: Un objeto mysqli_result devuelto por mysqli_query(), mysqli_store_result(), mysqli_use_result() o mysqli_stmt_get_result().
`index`

  El número del campo. Este valor debe estar en el intervalo `0` a `número de campos - 1`.

### Valores devueltos

Retorna siempre `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.0.0 | Esta función devuelve ahora siempre `true`. Anteriormente, devolvía `false` en caso de fallo.

### Ejemplos

Ejemplo #1 Estilo orientado a objetos

    <?php
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    /* Verificación de la conexión */
    if (mysqli_connect_errno()) {
        printf("Fallo en la conexión: %s\n", mysqli_connect_error());
        exit();
    }

    $query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

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

        /* Obtención de información del campo para la 2ª columna */
        $result->field_seek(1);
        $finfo = $result->fetch_field();

        printf("Name:     %s\n", $finfo->name);
        printf("Table:    %s\n", $finfo->table);
        printf("max. Len: %d\n", $finfo->max_length);
        printf("Flags:    %d\n", $finfo->flags);
        printf("Type:     %d\n\n", $finfo->type);

        $result->close();
    }

    /* Cierra la conexión */
    $mysqli->close();
    ?>

Ejemplo #2 Estilo procedimental

    <?php
    $link = mysqli_connect("localhost", "my_user", "my_password", "world");

    /* Verificación de la conexión */
    if (mysqli_connect_errno()) {
        printf("Fallo en la conexión: %s\n", mysqli_connect_error());
        exit();
    }

    $query = "SELECT Name, SurfaceArea from Country ORDER BY Code LIMIT 5";

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

        /* Obtención de información del campo para la 2ª columna */
        mysqli_field_seek($result, 1);
        $finfo = mysqli_fetch_field($result);

        printf("Name:     %s\n", $finfo->name);
        printf("Table:    %s\n", $finfo->table);
        printf("max. Len: %d\n", $finfo->max_length);
        printf("Flags:    %d\n", $finfo->flags);
        printf("Type:     %d\n\n", $finfo->type);

        mysqli_free_result($result);
    }

    /* Cierra la conexión */
    mysqli_close($link);
    ?>

Los ejemplos anteriores mostrarán:

    Name:     SurfaceArea
    Table:    Country
    max. Len: 10
    Flags:    32769
    Type:     4

### Ver también

- mysqli_fetch_field() - Devuelve el siguiente campo en el conjunto de resultados

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open