Manual do PHP
Anterior |  | Próxima

# mysqli_fetch_assoc

(PHP 5)

mysqli_fetch_assoc

(no version information, might be only in CVS)

mysqli->fetch_assoc -- Obtem uma linha do conjunto de resultados como uma matriz associativa

## Descrição

Estilo de procedimento:

array mysqli_fetch_assoc ( object result )

Estilo orientado a objeto (metodo):

class result {
array fetch_assoc ( void )
}

Retorna uma matriz associativa que corresponde a linha obtida, ou `NULL` se não houverem mais linhas.

A função mysqli_fetch_assoc() é usada para retornar uma matriz associativa representando a próxima linha no conjunto de resultados representado pelo parâmetro result, aonde cada chave representa o nome de uma coluna do conjunto de resultados.

Se duas ou mais colunas do resultado tiverem o mesmo nome do campo, a ultima coluna terá precedencia, Paa acessar as outra coluna(s) com o mesmo nome, você pode acessar o resultados com índices númericos usando a função mysqli_fetch_row() ou adicionar apelidos.

> 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.

## Valores de retorno

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

## Veja também

mysqli_fetch_array(), 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 DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { /* fetch associative array */ while ($row = $result->fetch_assoc()) { printf ("%s (%s)\n", $row["Name"], $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 DESC LIMIT 50,5"; if ($result = mysqli_query($link, $query)) { /* fetch associative array */ while ($row = mysqli_fetch_assoc($result)) { printf ("%s (%s)\n", $row["Name"], $row["CountryCode"]); } /* free result set */ mysqli_free_result($result); } /* close connection */ mysqli_close($link); ?>`

Os exempos acima devem produzir a seguinte saída:

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

Anterior | Principal | Próxima
mysqli_fetch_array | Acima | mysqli_fetch_field_direct