mysql_result
(PHP 4, PHP 5)
mysql_result — Retorna dados do resultado
Esta extensão tornou-se defasada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:
- mysqli_data_seek() em conjunto com mysqli_field_seek() e mysqli_fetch_field()
- PDOStatement::fetchColumn()
Descrição
Retorna o conteúdo de uma célula do resultado MySQL.
Ao trabalhar com conjuntos grandes de resultados, deve ser considerado o uso de uma das funções que retornam uma linha inteira (especificadas abaixo). Como estas funções retornam o conteúdo de múltiplas células em uma chamada de função, elas são MUITO mais rápidas que mysql_result(). Observe também que especificar um índice numérico para o argumento de campo (field) é muito mais rápido que especificar um argumento com nome de campo ou nome_tabela.nome_de_campo.
Parâmetros
-
result
O resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().
row
-
O número da linha do resultado que está sendo recuperado. Os números das linhas começam em
0
. field
-
O nome ou posição do campo que está sendo recuperado.
Pode ser a posição do campo, o nome do campo ou o nome da tabela mais um ponto mais o nome do campo (nome_tabela.nome_campo). Se o nome da coluna tiver servidor apelidada ('select foo as bar from...'), o apelido deve ser usado no lugar do nome da coluna. Se indefinido, o primeiro campo será recuperado.
Valor Retornado
O conteúdo de uma célula de um conjunto de resultado MySQL em caso de sucesso ou
false
em caso de falha.
Exemplos
Example #1 Exemplo de mysql_result()
<?php
$link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$link) {
die('Não foi possível conectar: ' . mysql_error());
}
if (!mysql_select_db('database_name')) {
die('Não foi possível selecionar o banco de dados: ' . mysql_error());
}
$result = mysql_query('SELECT name FROM work.employee');
if (!$result) {
die('Não foi possível consultar:' . mysql_error());
}
echo mysql_result($result, 2); // mostra o nome do terceiro empregado (employee)
mysql_close($link);
?>
Notas
Note:
Chamadas a mysql_result() não devem ser misturadas com chamadas a outras funções que lidam com o conjunto de resultados.
Veja Também
- mysql_fetch_row() - Obtém uma linha como um array numérico
- mysql_fetch_array() - Obtém uma linha de resultado como um array associativo, numérico, ou ambos
- mysql_fetch_assoc() - Obtém uma linha do resultado como um array associativo
- mysql_fetch_object() - Obtém o resultado de uma linha como um objeto