mysql_fetch_assoc
(PHP 4 >= 4.0.3, PHP 5)
mysql_fetch_assoc -- Obtém um linha do resultado como uma matriz associativa
Descrição
array
mysql_fetch_assoc ( resource result )
Retorna uma matriz associativa que corresponde a linha obtida
e move o ponteiro interno dos dados adiante.
mysql_fetch_assoc() é equivalente a utilizar
mysql_fetch_array() com MYSQL_ASSOC para o
segunto parâmetro, que é opcional. Ela apenas retorna a matriz associativa.
Valores de retornado
Retorna uma matriz associativa que corresponde a linha obtida, ou
FALSE se não houverem mais linhas.
Se duas ou mais colunas do resultado tiverem o mesmo nome de campo,
a ultima coluna terá precedencia. Para acessar as outras
coluna(s) com o mesmo nome, você precisa acessar os
outros resultados usando índices numéricos usando
mysql_fetch_row() ou adicionar nomes alias.
Veja o exemplo em mysql_fetch_array()
para uma descrição sobre alias.
Exemplos
Exemplo 1. Um exemplo expandido de mysql_fetch_assoc()
<?php
$conn = mysql_connect("localhost", "mysql_user", "mysql_password");
if (!$conn) { echo "Não foi possível conectar ao banco de dados: " . mysql_error(); exit; } if (!mysql_select_db("mydbname")) { echo "Não foi possível selecionar mydbname: " . mysql_error(); exit; }
$sql = "SELECT id as userid, fullname, userstatus FROM sometable WHERE userstatus = 1";
$result = mysql_query($sql);
if (!$result) { echo "Não foi possível executar a consulta ($sql) no banco de dados: " . mysql_error(); exit; }
if (mysql_num_rows($result) == 0) { echo "Não foram encontradas linhas, nada para mostrar, assim eu estou saindo"; exit; }
// Enquanto uma linha de dados existir, coloca esta linha em $row como uma matriz associativa // Nota: se você esta esperando apenas uma linha, não é necessário usar um loop // Nota: se você colocar extract($row); dentro do loop, você então // irá criar $userid, $fullname, e $userstatus while ($row = mysql_fetch_assoc($result)) { echo $row["userid"]; echo $row["fullname"]; echo $row["userstatus"]; }
mysql_free_result($result);
?>
|
|
Notas
Performance:
Uma coisa importante para notar é que usar
mysql_fetch_assoc() não
é significativamente mais lento do que usar
mysql_fetch_row(), enquanto provê
um valor agregado significante.
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.