Obtém o número de linhas em um resultado

# mysql_num_rows

(PHP 4, PHP 5)

mysql_num_rows — Obtém o número de linhas em um resultado

Aviso

Esta extensão foi descontinuada 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_num_rows()
- mysqli_stmt_num_rows()
- PDOStatement::rowCount()

### Descrição

function mysql_num_rows(resource `$result`): int|false

Obtém o numero de linhas de um conjunto de resultados. Este comando é valido apenas para comandos como SELECT ou SHOW que realmente retornam um conjunto de resultados. Para obter o numero de linhas afetadas por uma consulta INSERT, UPDATE, REPLACE ou DELETE, use mysql_affected_rows().

### Parâmetros

`result`
  O resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().

### Valor Retornado

O numero de linhas em um conjunto de resultados em caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo mysql_num_rows()

    <?php

    $link = mysql_connect("localhost", "mysql_user", "mysql_password");
    mysql_select_db("database", $link);

    $result = mysql_query("SELECT * FROM table1", $link);
    $num_rows = mysql_num_rows($result);

    echo "$num_rows Rows\n";

    ?>

### Notas

> Nota: Se você usar mysql_unbuffered_query(), mysql_num_rows() não irá retornar o valor correto até que todas as linhas no conjunto de resultado tenham sido obtidas.

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido descontinuado pode ser usado: mysql_numrows()

### Veja Também

- mysql_affected_rows() - Obtém o número de linhas afetadas na operação anterior do MySQL
- mysql_connect() - Abre uma conexão a um servidor MySQL
- mysql_data_seek() - Move o ponteiro interno do resultado
- mysql_select_db() - Seleciona um banco de dados MySQL
- mysql_query() - Envia uma consulta MySQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open