fbsql_fetch_field(3) [php man page]

FBSQL_FETCH_FIELD(3)							 1						      FBSQL_FETCH_FIELD(3)

fbsql_fetch_field - Get column information from a result and return as an object

SYNOPSIS

       object fbsql_fetch_field (resource  $result, [int  $field_offset])

DESCRIPTION

	Used in order to obtain information about fields in a certain query result.

PARAMETERS

	      o $
		result -A result identifier returned by fbsql_query(3) or fbsql_db_query(3).

	      o $field_offset
		-  The	numerical  offset of the field. The field index starts at 0. If not specified, the next field that wasn't yet retrieved by
		fbsql_fetch_field(3) is retrieved.

RETURN VALUES

	Returns an object containing field information, or FALSE on errors.

	The properties of the object are:

	      o name - column name

	      o table - name of the table the column belongs to

	      o max_length - maximum length of the column

	      o not_null - 1 if the column cannot be
		NULL

	      o type - the type of the column

EXAMPLES

       Example #1

	      fbsql_fetch_field(3) example

	      <?php
	      fbsql_connect($host, $user, $password)
		  or die("Could not connect");
	      $result = fbsql_db_query("database", "select * from table")
		  or die("Query failed");
	      # get column metadata
	      $i = 0;
	      while ($i < fbsql_num_fields($result)) {
		  echo "Information for column $i:<br />
";
		  $meta = fbsql_fetch_field($result);
		  if (!$meta) {
		      echo "No information available<br />
";
		  }
		  echo "<pre>
	      max_length:   $meta->max_length
	      name:	    $meta->name
	      not_null:     $meta->not_null
	      table:	    $meta->table
	      type:	    $meta->type
	      </pre>";
		  $i++;
	      }
	      fbsql_free_result($result);
	      ?>

SEE ALSO

       fbsql_field_seek(3).

PHP Documentation Group 												      FBSQL_FETCH_FIELD(3)

MSSQL_FIELD_SEEK(3)													       MSSQL_FIELD_SEEK(3)

mssql_field_seek - Seeks to the specified field offset

SYNOPSIS

       bool mssql_field_seek (resource	$result, int  $field_offset)

DESCRIPTION

	Seeks to the specified field offset. If the next call to mssql_fetch_field(3) won't include a field offset, this field would be returned.

PARAMETERS

	      o $result
		- The result resource that is being evaluated. This result comes from a call to mssql_query(3).

	      o $field_offset
		- The field offset, starts at 0.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Using mssql_field_seek(3) on the example for mssql_fetch_field(3)

	      <?php
	      // Connect to MSSQL and select the database
	      mssql_connect('MANGOSQLEXPRESS', 'sa', 'phpfi');
	      mssql_select_db('php');

	      // Send a select query to MSSQL
	      $query = mssql_query('SELECT * FROM [php].[dbo].[persons]');

	      // Construct table
	      echo '<h3>Table structure for 'persons'</h3>';
	      echo '<table border="1">';

	      // Table header
	      echo '<thead>';
	      echo '<tr>';
	      echo '<td>Field name</td>';
	      echo '<td>Data type</td>';
	      echo '<td>Max length</td>';
	      echo '</tr>';
	      echo '</thead>';

	      // Dump all fields
	      echo '<tbody>';

	      for ($i = 0; $i < mssql_num_fields($query); ++$i) {
		  // Fetch the field information, notice the
		  // field_offset parameter is not set. See
		  // the mssql_field_seek call below
		  $field = mssql_fetch_field($query);

		  // Print the row
		  echo '<tr>';
		  echo '<td>' . $field->name . '</td>';
		  echo '<td>' . strtoupper($field->type) . '</td>';
		  echo '<td>' . $field->max_length . '</td>';
		  echo '</tr>';

		  // Move the internal seek pointer to the next
		  // row in the result set
		  mssql_field_seek($query, $i + 1);
	      }

	      echo '</tbody>';
	      echo '</table>';

	      // Free the query result
	      mssql_free_result($query);
	      ?>

SEE ALSO

       mssql_fetch_field(3).

PHP Documentation Group 												       MSSQL_FIELD_SEEK(3)