php man page for maxdb_fetch_field

MAXDB_FETCH_FIELD(3)							 1						      MAXDB_FETCH_FIELD(3)

maxdb_fetch_field - Returns the next field in the result set

       Procedural style

SYNOPSIS
       mixed maxdb_fetch_field (resource  $result)

DESCRIPTION
       Object oriented style
       mixed maxdb_result::fetch_field (void  )

	The  maxdb_fetch_field(3)  returns  the definition of one column of a result set as an resource. Call this function repeatedly to retrieve
       information about all columns in the result set. maxdb_fetch_field(3) returns FALSE when no more fields are left.

RETURN VALUES
	Returns an resource which contains field definition information or FALSE if no field information is available.

       Object properties

       +-----------+---------------------------------------------------+
       | Property  |						       |
       |	   |						       |
       |	   |			Description		       |
       |	   |						       |
       +-----------+---------------------------------------------------+
       |   name    |						       |
       |	   |						       |
       |	   |		  The name of the column	       |
       |	   |						       |
       |max_length |						       |
       |	   |						       |
       |	   | The maximum width of the  field  for  the	result |
       |	   | set.					       |
       |	   |						       |
       |   type    |						       |
       |	   |						       |
       |	   |	     The data type used for this field	       |
       |	   |						       |
       | decimals  |						       |
       |	   |						       |
       |	   | The number of decimals used (for integer fields)  |
       |	   |						       |
       +-----------+---------------------------------------------------+
EXAMPLES
       Example #1

	      Object oriented style

	      <?php
	      $maxdb = new maxdb("localhost", "MONA", "RED", "DEMODB");

	      /* check connection */
	      if (maxdb_connect_errno()) {
		 printf("Connect failed: %s
", maxdb_connect_error());
		 exit();
	      }

	      $query = "SELECT name, cno from hotel.customer ORDER BY cno";

	      if ($result = $maxdb->query($query)) {

		 /* Get field information for all columns */
		 while ($finfo = $result->fetch_field()) {

		     printf("Name:     %s
", $finfo->name);
		     printf("Table:    %s
", $finfo->table);
		     printf("max. Len: %d
", $finfo->max_length);
		     printf("Flags:    %d
", $finfo->flags);
		     printf("Type:     %d

", $finfo->type);
		 }
		 $result->close();
	      }

	      /* close connection */
	      $maxdb->close();
	      ?>

       Example #2

	      Procedural style

	      <?php
	      $link = maxdb_connect("localhost", "MONA", "RED", "DEMODB");

	      /* check connection */
	      if (maxdb_connect_errno()) {
		 printf("Connect failed: %s
", maxdb_connect_error());
		 exit();
	      }

	      $query = "SELECT name, cno from hotel.customer ORDER BY cno";

	      if ($result = maxdb_query($link, $query)) {

		 /* Get field information for all fields */
		 while ($finfo = maxdb_fetch_field($result)) {

		     printf("Name:     %s
", $finfo->name);
		     printf("Table:    %s
", $finfo->table);
		     printf("max. Len: %d
", $finfo->max_length);
		     printf("Flags:    %d
", $finfo->flags);
		     printf("Type:     %d

", $finfo->type);
		 }
		 maxdb_free_result($result);
	      }

	      /* close connection */
	      maxdb_close($link);
	      ?>

       The above example will output something similar to:

       Name:	 NAME
       Table:
       max. Len: 10
       Flags:	 -1
       Type:	 2

       Name:	 CNO
       Table:
       max. Len: 4
       Flags:	 -1
       Type:	 0

SEE ALSO
       maxdb_num_fields(3), maxdb_fetch_field_direct(3), maxdb_fetch_fields(3), maxdb_field_seek(3).

PHP Documentation Group 												      MAXDB_FETCH_FIELD(3)