mysqli_result::fetch_column

mysqli_fetch_column

(PHP 8 >= 8.1.0)

mysqli_result::fetch_column -- mysqli_fetch_column — Recebe uma única coluna da próxima linha de um resultado

Descrição

Estilo orientado a objetos

public mysqli_result::fetch_column(int $column = 0): null|int|float|string|false

Estilo procedural

mysqli_fetch_column(mysqli_result $result, int $column = 0): null|int|float|string|false

Recebe uma linha de dados do resultado e retorna a coluna indexada a partir de 0. Cada chamada subsequente desta função retornará o valor da linha seguinte dentro do conjunto de resultados, ou false se não houver mais linhas.

Note: 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().

column

Número da coluna que se deseja receber da linha, sendo que a primeira é indexada em 0. Se nenhum valor for fornecido, a primeira coluna será retornada.

Valor Retornado

Retorna uma única coluna da próxima linha de um conjunto de resultados ou false se não houver mais linhas.

Warning

Não há como retornar outra coluna da mesma linha se esta função for usada para obter dados.

Exemplos

Example #1 Exemplo de mysqli_result::fetch_column()

Estilo orientado a objetos

<?php

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

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

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

/* recebe um único valor da segunda coluna */
while ($Name = $result->fetch_column(1)) {
    printf("%s\n", $Name);
}

Estilo procedural

<?php

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

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

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

/* recebe um único valor da segunda coluna */
while ($Name = mysqli_fetch_column($result, 1)) {
    printf("%s\n", $Name);
}

Os exemplos acima produzirão algo semelhante a:

Rafah
Nablus
Jabaliya
Hebron
Khan Yunis

Veja Também