Manual do PHP
Anterior |  | Próxima

# mysqli_data_seek

(PHP 5)

mysqli_data_seek

(no version information, might be only in CVS)

result->data_seek -- Ajusta o ponteiro do resultado para uma linha arbritaria no conjunto de resutados

## Descrição

Estilo de procedimento:

bool mysqli_data_seek ( object result, int offset )

Estilo orientado a objetos (metodo):

class result {
bool data_seek ( int offset )
}

A função mysqli_data_seek() move para um resultado arbritario especificado por offset no conjunto de resultados especificado por result. O parâmetro offset deve estar entre zero e o número total de linhas menos uma (0..mysqli_num_rows() - 1).

> Nota: Esta função só pode ser usadas para consultas não guardadas em buffer guardadas com o uso de mysqli_store_result() ou mysqli_query().

## Valores de retorno

Retorna `TRUE` em caso de sucesso ou `FALSE` em falhas.

## Veja também

mysqli_store_result(), mysqli_fetch_row(), mysqli_num_rows().

## Exemplo

Exemplo 1. Estilo orientado a objeto
`<?php /* Open a connection */ $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 Name"; if ($result = $mysqli->query( $query)) { /* seek to row no. 400 */ $result->data_seek(399); /* fetch row */ $row = $result->fetch_row(); printf ("City: %s Countrycode: %s\n", $row[0], $row[1]); /* free result set*/ $result->close(); } /* close connection */ $mysqli->close(); ?>`

Exemplo 2. Estilo de procedimento
`<?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER BY Name"; if ($result = mysqli_query($link, $query)) { /* seek to row no. 400 */ mysqli_data_seek($result, 399); /* fetch row */ $row = mysqli_fetch_row($result); printf ("City: %s Countrycode: %s\n", $row[0], $row[1]); /* free result set*/ mysqli_free_result($result); } /* close connection */ mysqli_close($link); ?>`

Os exemplos acima devem produzir a seguinte saída:

    City: Benin City  Countrycode: NGA

Anterior | Principal | Próxima
mysqli_connect | Acima | mysqli_debug