Documentation Home
MySQL PHP API
Download this Manual
PDF (US Ltr) - 2.4Mb
PDF (A4) - 2.4Mb


MySQL PHP API  /  ...  /  mysqli_result::fetch_column, mysqli_fetch_column

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 3.112 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