Latest web development tutorials
 

PHP mysqli_fetch_field_direct() Function

< PHP MySQLi Reference

Example

Return meta-data for a single field (column) in the result set, then print the field's name, table, and max length:

<?php
$con=mysqli_connect("localhost","my_user","my_password","my_db");
// Check connection
if (mysqli_connect_errno())
  {
  echo "Failed to connect to MySQL: " . mysqli_connect_error();
  }

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

if ($result=mysqli_query($con,$sql))
  {
  // Get field information for "Age"
  $fieldinfo=mysqli_fetch_field_direct($result,1);

  printf("Name: %s\n",$fieldinfo->name);
  printf("Table: %s\n",$fieldinfo->table);
  printf("max. Len: %d\n",$fieldinfo->max_length);

  // Free result set
  mysqli_free_result($result);
}

mysqli_close($con);
?>

Definition and Usage

The mysqli_fetch_field_direct() function returns meta-data for a single field (column) in the result set, as an object.


Syntax

mysqli_fetch_field_direct(result,fieldnr);

Parameter Description
result Required. Specifies a result set identifier returned by mysqli_query() , mysqli_store_result() or mysqli_use_result()
fieldnr Required. Specifies the field number. Must be an integer between 0 and number of fields - 1

Technical Details

Return Value: Returns an object containing field definition information. FALSE if no info is available. The object has the following properties:
  • name - name of the column
  • orgname - original column name (if an alias is specified)
  • table - name of table
  • orgtable - original table name (if an alias is specified)
  • def - default value for this field
  • max_length - maximum width of field
  • length - width of field as specified in table definition
  • charsetnr - character set number for the field
  • flags - bit-flags for the field
  • type - data type used for the field
  • decimals - for integer fields; the number of decimals used
PHP Version: 5+

< PHP MySQLi Reference