pg_last_oid(3) [php man page]

PG_LAST_OID(3)															    PG_LAST_OID(3)

pg_last_oid - Returns the last row's OID

SYNOPSIS

       string pg_last_oid (resource  $result)

DESCRIPTION

       pg_last_oid(3) is used to retrieve the $OID assigned to an inserted row.

	OID  field  became  an	optional field from PostgreSQL 7.2 and will not be present by default in PostgreSQL 8.1. When the OID field is not
       present in a table, the programmer must use pg_result_status(3) to check for successful insertion.

	To get the value of a SERIAL field in an inserted row, it is necessary to use the PostgreSQL CURRVAL function, naming the  sequence  whose
       last value is required. If the name of the sequence is unknown, the pg_get_serial_sequence PostgreSQL 8.0 function is necessary.

	PostgreSQL  8.1  has a function LASTVAL that returns the value of the most recently used sequence in the session. This avoids the need for
       naming the sequence, table or column altogether.

       Note

	       This function used to be called pg_getlastoid(3).

PARAMETERS

	      o $result
		- PostgreSQL query result resource, returned by pg_query(3), pg_query_params(3) or pg_execute(3) (among others).

RETURN VALUES

	A string containing the OID assigned to the most recently inserted row in the specified $connection, or FALSE on  error  or  no  available
       OID.

EXAMPLES

       Example #1

	      pg_last_oid(3) example

	      <?php
		// Connect to the database
		pg_connect("dbname=mark host=localhost");

		// Create a sample table
		pg_query("CREATE TABLE test (a INTEGER) WITH OIDS");

		// Insert some data into it
		$res = pg_query("INSERT INTO test VALUES (1)");

		$oid = pg_last_oid($res);
	      ?>

SEE ALSO

       pg_query(3), pg_result_status(3).

PHP Documentation Group 													    PG_LAST_OID(3)

PG_FIELD_NAME(3)														  PG_FIELD_NAME(3)

pg_field_name - Returns the name of a field

SYNOPSIS

       string pg_field_name (resource  $result, int  $field_number)

DESCRIPTION

       pg_field_name(3)  returns the name of the field occupying the given $field_number in the given PostgreSQL $result resource. Field numbering
       starts from 0.

       Note

	       This function used to be called pg_fieldname(3).

PARAMETERS

	      o $result
		- PostgreSQL query result resource, returned by pg_query(3), pg_query_params(3) or pg_execute(3) (among others).

	      o $field_number
		- Field number, starting from 0.

RETURN VALUES

	The field name, or FALSE on error.

EXAMPLES

       Example #1

	      Getting information about fields

	      <?php
		$dbconn = pg_connect("dbname=publisher") or die("Could not connect");

		$res = pg_query($dbconn, "select * from authors where author = 'Orwell'");
		$i = pg_num_fields($res);
		for ($j = 0; $j < $i; $j++) {
		    echo "column $j
";
		    $fieldname = pg_field_name($res, $j);
		    echo "fieldname: $fieldname
";
		    echo "printed length: " . pg_field_prtlen($res, $fieldname) . " characters
";
		    echo "storage length: " . pg_field_size($res, $j) . " bytes
";
		    echo "field type: " . pg_field_type($res, $j) . " 

";
		}
	      ?>

	      The above example will output:

	      column 0
	      fieldname: author
	      printed length: 6 characters
	      storage length: -1 bytes
	      field type: varchar

	      column 1
	      fieldname: year
	      printed length: 4 characters
	      storage length: 2 bytes
	      field type: int2

	      column 2
	      fieldname: title
	      printed length: 24 characters
	      storage length: -1 bytes
	      field type: varchar

SEE ALSO

       pg_field_num(3).

PHP Documentation Group 													  PG_FIELD_NAME(3)