PhpDig.net

What is PhpDig?
PhpDig is a PHP MySQL based
Web Spider & Search Engine.




mysql_field_type

Name

mysql_field_type — Gets the type of the specified field.

Synopsis

string mysql_field_type(result_handle, field_offset);
mysql result result_handle: Result handle returned by mysql_db_query() or mysql_query()
int field_offset: Field offset to use

Returns

String; FALSE on error

Description

mysql_field_type() returns the type of the specified field in a query. The field_offset argument specifies the desired field. Field offsets start at 0.

The types returned by this function are similar but not identical to MySQL's column types. If the column value is generated by an expression, the type of the result determines the type of the column. For example, suppose this is the query:

SELECT count(user);


The type would be int.

The following table lists the types.

Type Description
blob A column containing or an expression that returns a Binary Long OBject. This includes all BLOB or TEXT type columns.
date A DATE column. Expressions that return a date value are of type int, real, orstring, depending on the value returned.
datetime A DATETIME column. Expressions that return a datetime value are of type int, real, orstring, depending on the value returned.
int A column containing or an expression that returns integer data. This includes all INT type columns.
null An expression that returns NULL.
real A column containing or an expression that returns a floating-point number. This includes the DECIMAL, FLOAT, and DOUBLE column types.
string

A CHAR, ENUM, SET, or VARCHAR column, or an expression that returns character data.

Note

Even if the number of characters returned by an expression exceeds the maximum length of 255 characters for a CHAR/VARCHAR column, the type returned is string and not blob, as you might expect.

time A TIME column. Expressions that return a time value are of type realor string, depending on the value returned.
timestamp A TIMESTAMP column. Expressions that return a timestamp value are of type int.
year A YEAR column. Expressions that return a year value are of type int.
unknown A type that doesn't match any type known by mysql_field_type() . An occurrence of this type may indicate that the version of MySQL is more recent than the version of PHP.


Version

PHP 3+, PHP 4+

See also

To find the number of rows affected by a query:

mysql_num_rows()



Example

Example 815. Find the field types for the fields in a query

<?php
// Included code that connects to a MySQL server and sets a default database
// See the MySQL Functions chapter introduction for the source code for the file
include ('mysql_connect.inc.php');

// A SELECT query using a column name and a few functions
$query = "SELECT login, UNIX_TIMESTAMP(), NOW() FROM user";

// Run the query
$mysql_result = @ mysql_query ($query)
    or die ("Query '$query' failed with error message: \"" . mysql_error () . '"');

// Grab information on every other field in the result set
// Display the object containing field information
for ($offset = 0; $offset < mysql_num_fields ($mysql_result); ++$offset) {

   // Find the name of the current field
   $field_name = mysql_field_name ($mysql_result, $offset);

   // Find the type of the current field
   $field_type = mysql_field_type ($mysql_result, $offset);

   echo "Field '$field_name' is of type '$field_type'.<br />";
}
?>



PHP Functions Essential Reference. Copyright © 2002 by New Riders Publishing (Authors: Zak Greant, Graeme Merrall, Torben Wilson, Brett Michlitsch). This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is presently available at http://www.opencontent.org/openpub/). The authors of this book have elected not to choose any options under the OPL. This online book was obtained from http://www.fooassociates.com/phpfer/ and is designed to provide information about the PHP programming language, focusing on PHP version 4.0.4 for the most part. The information is provided on an as-is basis, and no warranty or fitness is implied. All persons and entities shall have neither liability nor responsibility to any person or entity with respect to any loss or damage arising from the information contained in this book.

Powered by: vBulletin Version 3.0.7
Copyright ©2000 - 2005, Jelsoft Enterprises Ltd.
Copyright © 2001 - 2005, ThinkDing LLC. All Rights Reserved.