PHP 5.4.31 Released

oci_field_name

(PHP 5, PECL OCI8 >= 1.1.0)

oci_field_nameReturns the name of a field from the statement

Description

string oci_field_name ( resource $statement , int $field )

Returns the name of the field.

Parameters

statement

A valid OCI statement identifier.

field

Can be the field's index (1-based) or name.

Return Values

Returns the name as a string, or FALSE on errors.

Examples

Example #1 oci_field_name() example

<?php
$conn 
oci_connect("scott""tiger");
$stmt oci_parse($conn"SELECT * FROM emp");
oci_execute($stmt);

echo 
"<table border=\"1\">";
echo 
"<tr>";
echo 
"<th>Name</th>";
echo 
"<th>Type</th>";
echo 
"<th>Length</th>";
echo 
"</tr>";

$ncols oci_num_fields($stmt);

for (
$i 1$i <= $ncols$i++) {
    
$column_name  oci_field_name($stmt$i);
    
$column_type  oci_field_type($stmt$i);
    
$column_size  oci_field_size($stmt$i);

    echo 
"<tr>";
    echo 
"<td>$column_name</td>";
    echo 
"<td>$column_type</td>";
    echo 
"<td>$column_size</td>";
    echo 
"</tr>";
}

echo 
"</table>\n";
oci_free_statement($stmt);
oci_close($conn);
?>

Notes

Note:

In PHP versions before 5.0.0 you must use ocicolumnname() instead. This name still can be used, it was left as alias of oci_field_name() for downwards compatability. This, however, is deprecated and not recommended.

See Also

add a note add a note

User Contributed Notes 2 notes

up
1
Paul
3 years ago
Beware, the field index starts with 1, not 0. It's a bit counter-intuitive.
up
-1
Norbert
3 years ago
This does not work for empty tables.
To Top