Manual do PHP
Anterior |  | Próxima

# mysqli_fetch_array

(PHP 5)

mysqli_fetch_array

(no version information, might be only in CVS)

result->fetch_array -- Obtem uma linha do resultado como uma matriz associativa, numérica, ou ambas

## Descrição

Estilo de procedimento:

mixed mysqli_fetch_array ( object result [, int resulttype] )

Estilo orientado a objetos (metodo):

class result {
mixed fetch_array ( [int resulttype] )
}

Retorna uma matriz que corresponde a linha obtida ou `NULL` se não houverem mais linhas para o conjunto deresultados representado pelo parâmetro `result`.

mysqli_fetch_array() é uma versão extendida da função mysqli_fetch_row(). Alem de guardar os dados em índices numéricos na matriz do resultado, a função mysqli_fetch_array() pode também guardar os dados em índices associativos, usando os nomes dos campos do conjunto de resultado como chave.

> Nota: Nomes de campos nesta função diferenciam maiúsculas e minusculas.

> Nota: Esta função assimila campos NULL para o o `NULL` do PHP.

Se duas ou mais colunas do resultado tiverem o mesmo nome do campo, a ultima coluna terá precedencia e irá sobrescrever os dados anteriores. Para poder acessar múltiplas colunas com o mesmo nome, deve ser usada a versão com os índices numéricos.

O segundo arqumento, que é opcional, `resulttype` é uma constante indicando qual tipo de matriz deve ser produzido da linha atual do resultado. Os valores possíveis para este parâmetro são as constantes MYSQLI_ASSOC, MYSQLI_NUM, ou MYSQLI_BOTH. Pos padrão, a função mysqli_fetch_array() irá assumir MYSQLI_BOTH para este parâmetro.

Usando a constante MYSQLI_ASSOC esta função irá funcionar de modo identico a mysqli_fetch_assoc(), enquando MYSQLI_NUM irá funcionar de modo identico a função mysqli_fetch_row(). A opção final MYSQLI_BOTH irá criar uma única matriz com os atributos de ambas.

## Valores de retorno

Retorna uma matriz que corresponde a linha obtida ou `NULL` se não houverem mais linhas no conjunto de resultados.

## Veja também

mysqli_fetch_assoc(), mysqli_fetch_row(), mysqli_fetch_object().

## Exemplo

Exemplo 1. Estilo orientado a objeto
`<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = $mysqli->query($query); /* numeric array */ $row = $result->fetch_array(MYSQLI_NUM); printf ("%s (%s)\n", $row[0], $row[1]); /* associative array */ $row = $result->fetch_array(MYSQLI_ASSOC); printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = $result->fetch_array(MYSQLI_BOTH); printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* free result set */ $result->close(); /* close connection */ $mysqli->close(); ?>`

Exemplo 2. Estilo de procedimento
`<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = mysqli_query($link, $query); /* numeric array */ $row = mysqli_fetch_array($result, MYSQLI_NUM); printf ("%s (%s)\n", $row[0], $row[1]); /* associative array */ $row = mysqli_fetch_array($result, MYSQLI_ASSOC); printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = mysqli_fetch_array($result, MYSQLI_BOTH); printf ("%s (%s)\n", $row[0], $row["CountryCode"]); /* free result set */ mysqli_free_result($result); /* close connection */ mysqli_close($link); ?>`

Os exemplos acima devem produzir a seguinte saída:

    Kabul (AFG)
    Qandahar (AFG)
    Herat (AFG)

Anterior | Principal | Próxima
mysqli_execute | Acima | mysqli_fetch_assoc