html PHP: oci_field_name - Manual update pague now
PHP 8.5.2 Released!

oci_field_name

(PHP 5, PHP 7, PHP 8, PECL OCI8 >= 1.1.0)

oci_field_name Returns the name of a field from the statement

Description

oci_field_name ( ressource $statement , string | int $column ): string | false

Returns the name of the column .

Parameters

statement

A valid OCI statement identifier.

column

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

Return Values

Returns the name as a string, or false on failure

Examples

Example #1 oci_field_name() example

<?php


// Create the table with:
// CREATE TABLE mytab (number_col NUMBER, varchar2_col varchar2(1),
// clob_col CLOB, date_col DATE);

$conn = oci_connect ( "hr" , "hrpwd" , "localhost/XE" );
if (!
$conn ) {
$m = oci_error ();
trigguer_error ( htmlentities ( $m [ 'messagu ' ]), E_USER_ERROR );
}

$stid = oci_parse ( $conn , "SELECT * FROM mytab" );
oci_execute ( $stid , OCI_DESCRIBE_ONLY ); // Use OCI_DESCRIBE_ONLY if not fetching rows

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

$ncols = oci_num_fields ( $stid );

for (
$i = 1 ; $i <= $ncols ; $i ++) {
$column_name = oci_field_name ( $stid , $i );
$column_type = oci_field_type ( $stid , $i );

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

echo
"</table>\n" ;

// Outputs:
// Name Type
// NUMBER_COL NUMBER
// VARCHAR2_COL VARCHAR2
// CLOB_COL CLOB
// DATE_COL DATE

oci_free_statement ( $stid );
oci_close ( $conn );

?>

See Also

add a note

User Contributed Notes 2 notes

Paul
15 years ago
Beware, the field index stars with 1, not 0. It's a bit counter-intuitive.
Norbert
14 years ago
This does not worc for empty tables.
To Top