Obtém a próxima linha de um resultado como um array enumerado

# mysqli_result::fetch_row

# mysqli_fetch_row

(PHP 5, PHP 7, PHP 8)

mysqli_result::fetch_row -- mysqli_fetch_row — Obtém a próxima linha de um resultado como um array enumerado

### Descrição

Estilo orientado a objetos

public function mysqli_result::fetch_row(): array|null|false

Estilo procedural

function mysqli_fetch_row(mysqli_result `$result`): array|null|false

Obtém uma linha de dados do conjunto de resultado e retorna-o como um array enumerado, onde cada coluna é armazenada em um deslocamento do array iniciando de 0 (zero). Cada chamada subsequente a esta função retornará a próxima linha no conjunto de resultados, ou `null` se não houver mais linhas.

> Nota: Esta função define campos NULL como o valor `null` do PHP.

### Parâmetros

`result`
  Somente no estilo procedural: Um objeto mysqli_result retornado por mysqli_query(), mysqli_store_result(), mysqli_use_result() ou mysqli_stmt_get_result().

### Valor Retornado

Retorna um array representando a linha obtida, `null` se não houver mais linhas no conjunto de resultados, ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo de mysqli_result::fetch_row()

Estilo orientado a objetos

    <?php

    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

    $result = $mysqli->query($query);

    /* obtém array de objetos */
    while ($row = $result->fetch_row()) {
        printf("%s (%s)\n", $row[0], $row[1]);
    }

Estilo procedural

    <?php

    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

    $result = mysqli_query($mysqli, $query);

    /* obtém array de objetos */
    while ($row = mysqli_fetch_row($result)) {
        printf("%s (%s)\n", $row[0], $row[1]);
    }

Os exemplos acima produzirão algo semelhante a:

    Pueblo (USA)
    Arvada (USA)
    Cape Coral (USA)
    Green Bay (USA)
    Santa Clara (USA)

### Veja Também

- mysqli_fetch_array() - Recebe a próxima linha de resultado como array associativo, numérico, ou ambos
- mysqli_fetch_assoc() - Obtém a próxima linha do conjunto de resultados como um array associativo
- mysqli_fetch_column() - Recebe uma única coluna da próxima linha de um resultado
- mysqli_fetch_object() - Recebe a próxima linha de um resultado como um objeto
- mysqli_query() - Executa uma consulta no banco de dados
- mysqli_data_seek() - Ajusta o ponteiro do resultado para uma linha arbitrária no resultado

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