Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mysqli_data_seek(3) [php man page]

MYSQLI_DATA_SEEK(3)							 1						       MYSQLI_DATA_SEEK(3)

mysqli_result::data_seek - Adjusts the result pointer to an arbitrary row in the result

       Object oriented style

SYNOPSIS
bool mysqli_result::data_seek (int $offset) DESCRIPTION
Procedural style bool mysqli_data_seek (mysqli_result $result, int $offset) The mysqli_data_seek(3) function seeks to an arbitrary result pointer specified by the $offset in the result set. PARAMETERS
o $ result -Procedural style only: A result set identifier returned by mysqli_query(3), mysqli_store_result(3) or mysqli_use_result(3). o $offset - The field offset. Must be between zero and the total number of rows minus one (0..mysqli_num_rows(3) - 1). RETURN VALUES
Returns TRUE on success or FALSE on failure. NOTES
Note This function can only be used with buffered results attained from the use of the mysqli_store_result(3) or mysqli_query(3) func- tions. EXAMPLES
Example #1 Object oriented style <?php /* Open a connection */ $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s ", 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 ", $row[0], $row[1]); /* free result set*/ $result->close(); } /* close connection */ $mysqli->close(); ?> Example #2 Procedural style <?php /* Open a connection */ $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (!$link) { printf("Connect failed: %s ", 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 ", $row[0], $row[1]); /* free result set*/ mysqli_free_result($result); } /* close connection */ mysqli_close($link); ?> The above examples will output: City: Benin City Countrycode: NGA SEE ALSO
mysqli_store_result(3), mysqli_fetch_row(3), mysqli_fetch_array(3), mysqli_fetch_assoc(3), mysqli_fetch_object(3), mysqli_query(3), mysqli_num_rows(3). PHP Documentation Group MYSQLI_DATA_SEEK(3)

Check Out this Related Man Page

MYSQLI_FETCH_ARRAY(3)							 1						     MYSQLI_FETCH_ARRAY(3)

mysqli_result::fetch_array - Fetch a result row as an associative, a numeric array, or both

       Object oriented style

SYNOPSIS
mixed mysqli_result::fetch_array ([int $resulttype = MYSQLI_BOTH]) DESCRIPTION
Procedural style mixed mysqli_fetch_array (mysqli_result $result, [int $resulttype = MYSQLI_BOTH]) Returns an array that corresponds to the fetched row or NULL if there are no more rows for the resultset represented by the $result param- eter. mysqli_fetch_array(3) is an extended version of the mysqli_fetch_row(3) function. In addition to storing the data in the numeric indices of the result array, the mysqli_fetch_array(3) function can also store the data in associative indices, using the field names of the result set as keys. Note Field names returned by this function are case-sensitive. Note This function sets NULL fields to the PHP NULL value. If two or more columns of the result have the same field names, the last column will take precedence and overwrite the earlier data. In order to access multiple columns with the same name, the numerically indexed version of the row must be used. PARAMETERS
o $ result -Procedural style only: A result set identifier returned by mysqli_query(3), mysqli_store_result(3) or mysqli_use_result(3). o $resulttype - This optional parameter is a constant indicating what type of array should be produced from the current row data. The possible values for this parameter are the constants MYSQLI_ASSOC, MYSQLI_NUM, or MYSQLI_BOTH. By using the MYSQLI_ASSOC constant this function will behave identically to the mysqli_fetch_assoc(3), while MYSQLI_NUM will behave identically to the mysqli_fetch_row(3) function. The final option MYSQLI_BOTH will create a single array with the attributes of both. RETURN VALUES
Returns an array of strings that corresponds to the fetched row or NULL if there are no more rows in resultset. EXAMPLES
Example #1 Object oriented style <?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* check connection */ if ($mysqli->connect_errno) { printf("Connect failed: %s ", $mysqli->connect_error); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = $mysqli->query($query); /* numeric array */ $row = $result->fetch_array(MYSQLI_NUM); printf ("%s (%s) ", $row[0], $row[1]); /* associative array */ $row = $result->fetch_array(MYSQLI_ASSOC); printf ("%s (%s) ", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = $result->fetch_array(MYSQLI_BOTH); printf ("%s (%s) ", $row[0], $row["CountryCode"]); /* free result set */ $result->free(); /* close connection */ $mysqli->close(); ?> Example #2 Procedural style <?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* check connection */ if (mysqli_connect_errno()) { printf("Connect failed: %s ", mysqli_connect_error()); exit(); } $query = "SELECT Name, CountryCode FROM City ORDER by ID LIMIT 3"; $result = mysqli_query($link, $query); /* numeric array */ $row = mysqli_fetch_array($result, MYSQLI_NUM); printf ("%s (%s) ", $row[0], $row[1]); /* associative array */ $row = mysqli_fetch_array($result, MYSQLI_ASSOC); printf ("%s (%s) ", $row["Name"], $row["CountryCode"]); /* associative and numeric array */ $row = mysqli_fetch_array($result, MYSQLI_BOTH); printf ("%s (%s) ", $row[0], $row["CountryCode"]); /* free result set */ mysqli_free_result($result); /* close connection */ mysqli_close($link); ?> The above examples will output: Kabul (AFG) Qandahar (AFG) Herat (AFG) SEE ALSO
mysqli_fetch_assoc(3), mysqli_fetch_row(3), mysqli_fetch_object(3), mysqli_query(3), mysqli_data_seek(3). PHP Documentation Group MYSQLI_FETCH_ARRAY(3)
Man Page