mysqli_result::fetch_field

Definition and usage

fetch_field() / mysqli_fetch_field() function returns the next field (column) in the result set as an object.

Example

Example 1 - Object-Oriented Style

Return the next field (column) in the result set, and print the name, table, and maximum length of each field:

 <?php
$mysqli = new mysqli ( "localhost" , "my_user" , "my_password" , "my_db" ) ;

if ( $mysqli -> connect_errno ) {
  echo "Failed to connect to MySQL: " . $mysqli -> connect_error ;
  exit ( ) ;
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname" ;

if ( $result = $mysqli -> query ( $sql ) ) {
  // Get field information for all fields
  while ( $fieldinfo = $result -> fetch_field ( ) ) {
    printf ( "Name: %s\n" , $fieldinfo -> name ) ;
    printf ( "Table: %s\n" , $fieldinfo -> table ) ;
    printf ( "Max. Len: %d\n" , $fieldinfo -> max_length ) ;
  }
  $result -> free_result ( ) ;
}

$mysqli -> close ( ) ;
?>

Example 2 - Procedural Style

Return the next field (column) in the result set, and print the name, table, and maximum length of each field:

 <?php
$con = mysqli_connect ( "localhost" , "my_user" , "my_password" , "my_db" ) ;

if ( mysqli_connect_errno ( ) ) {
  echo "Failed to connect to MySQL: " . mysqli_connect_error ( ) ;
  exit ( ) ;
}

$sql = "SELECT Lastname, Age FROM Persons ORDER BY Lastname" ;

if ( $result = mysqli_query ( $con , $sql ) ) {
  // Get field information for all fields
  while ( $fieldinfo = mysqli_fetch_field ( $result ) ) {
    printf ( "Name: %s\n" , $fieldinfo -> name ) ;
    printf ( "Table: %s\n" , $fieldinfo -> table ) ;
    printf ( "max. Len: %d\n" , $fieldinfo -> max_length ) ;
  }
  mysqli_free_result ( $result ) ;
}

mysqli_close ( $con ) ;
?>