7.3.10.7 mysqli_result::fetch_column, mysqli_fetch_column

Copyright 1997-2022 the PHP Documentation Group.

• mysqli_result::fetch_column

  mysqli_fetch_column

  Fetch a single column from the next row of a result set

Description

Object-oriented style

public null|int|float|string|false mysqli_result::fetch_column(int column= =0);

Procedural style

null|int|float|string|false mysqli_fetch_column(mysqli_result result,
                                                int column= =0);

Fetches one row of data from the result set and returns the 0-indexed column. Each subsequent call to this function will return the value from the next row within the result set, or false if there are no more rows.

Note

This function sets NULL fields to the PHP null value.

Parameters

result

Procedural style only: A mysqli_result object returned by mysqli_query, mysqli_store_result, mysqli_use_result or mysqli_stmt_get_result.

column

0-indexed number of the column you wish to retrieve from the row. If no value is supplied, the first column will be returned.

Return Values

Returns a single column from the next row of a result set or false if there are no more rows.

Warning

There is no way to return another column from the same row if you use this function to retrieve data.

Examples

Example 7.119 mysqli_result::fetch_column example

Object-oriented style

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
$query = "SELECT CountryCode, Name FROM City ORDER BY ID DESC LIMIT 5";
$result = $mysqli->query($query);
/* fetch a single value from the second column */
while ($Name = $result->fetch_column(1)) {
    printf("%s\n", $Name);
}

Procedural style

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");
$query = "SELECT CountryCode, Name FROM City ORDER BY ID DESC LIMIT 5";
$result = mysqli_query($mysqli, $query);
/* fetch a single value from the second column */
while ($Name = mysqli_fetch_column($result, 1)) {
    printf("%s\n", $Name);
}

The above examples will output something similar to:

Rafah
Nablus
Jabaliya
Hebron
Khan Yunis

See Also

mysqli_fetch_all

mysqli_fetch_array

mysqli_fetch_assoc

mysqli_fetch_object

mysqli_fetch_row

mysqli_data_seek