Become Zend Certified

Prepare for the ZCE exam using our quizzes (web or iPad/iPhone). More info...

When you're ready get 7.5% off your exam voucher using voucher CJQNOV23 at the Zend Store


(No version information available, might only be in SVN)

sqlsrv_field_metadataRetrieves metadata for the fields of a statement prepared by sqlsrv_prepare() or sqlsrv_query()


mixed sqlsrv_field_metadata ( resource $stmt )

Retrieves metadata for the fields of a statement prepared by sqlsrv_prepare() or sqlsrv_query(). sqlsrv_field_metadata() can be called on a statement before or after statement execution.



The statment resource for which metadata is returned.

Return Values

Returns an array of arrays is returned on success. Otherwise, FALSE is returned. Each returned array is described by the following table:

Array returned by sqlsrv_field_metadata
Key Description
Name The name of the field.
Type The numeric value for the SQL type.
Size The number of characters for fields of character type, the number of bytes for fields of binary type, or NULL for other types.
Precision The precision for types of variable precision, NULL for other types.
Scale The scale for types of variable scale, NULL for other types.
Nullable An enumeration indicating whether the column is nullable, not nullable, or if it is not known.
For more information, see » sqlsrv_field_metadata in the Microsoft SQLSRV documentation.


Example #1 sqlsrv_field_metadata() example

$connectionInfo = array( "Database"=>"AdventureWorks""UID"=>"username""PWD"=>"password");
$conn sqlsrv_connect$serverName$connectionInfo);
$conn === false ) {
print_rsqlsrv_errors(), true));

$sql "SELECT * FROM Table_1";
$stmt sqlsrv_prepare$conn$sql );

sqlsrv_field_metadata$stmt ) as $fieldMetadata ) {
$fieldMetadata as $name => $value) {
"$name$value<br />";
"<br />";

See Also

PHP Manual