mysql_data_seek

    (PHP 4, PHP 5)

    mysql_data_seek — Move o ponteiro interno do resultado

    Aviso

    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:

    Descrição

    mysql_data_seek(resource$result, int$row_number): bool

    mysql_data_seek() move o ponteiro interno da linha de um resultado MySQL associado ao identificador de resultado informado para o número da linha especificada. A próxima chamada a uma função MySQL que retorna resultado, como mysql_fetch_assoc(), irá retornar esta linha.

    row_number começa em 0. O row_number deve ser um valor no intervalo de 0 a mysql_num_rows() - 1. Entretanto, se o conjunto de reseultados for vazio (mysql_num_rows() == 0), uma busca para 0 irá falhar com um E_WARNING e mysql_data_seek() iá retornar false.

    Parâmetros

    result

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

    row_number

    O número de linha desejado para o ponteiro de resultado.

    Valor Retornado

    Retorna true em caso de sucesso ou false em caso de falha.

    Exemplos

    Exemplo #1 Exemplo mysql_data_seek()

    <?php
    $link     = mysql_connect('localhost', 'mysql_user', 'mysql_password');
    if (!    $link) {
    die(    'Could not connect: ' . mysql_error());
    }
    $db_selected = mysql_select_db('sample_db');
    if (!    $db_selected) {
    die(    'Could not select database: ' . mysql_error());
    }
    $query = 'SELECT last_name, first_name FROM friends';
    $result = mysql_query($query);
    if (!    $result) {
    die(    'Query failed: ' . mysql_error());
    }

    for ($i = mysql_num_rows($result) - 1; $i >= 0; $i--) {
    if (!    mysql_data_seek($result, $i)) {
    echo     "Cannot seek to row $i: " . mysql_error() . "\n";
    continue;
    }

    if (!(    $row = mysql_fetch_assoc($result))) {
    continue;
    }

    echo     $row['last_name'] . ' ' . $row['first_name'] . "<br />\n";
    }

    mysql_free_result($result);
    ?>

    Notas

    Nota:

    A função mysql_data_seek() pode ser usada apenas em conjunto com a função mysql_query(), não com mysql_unbuffered_query().

    Veja Também

    To Top