Provided by: postgresql-client-8.0_8.0.7-2build1_i386 bug

NAME

       SPI_returntuple - prepare to return a tuple as a Datum

SYNOPSIS

       HeapTupleHeader SPI_returntuple(HeapTuple row, TupleDesc rowdesc)

DESCRIPTION

       SPI_returntuple  makes  a  copy of a row in the upper executor context,
       returning it in the form of a row type  Datum.   The  returned  pointer
       need only be converted to Datum via PointerGetDatum before returning.

       Note that this should be used for functions that are declared to return
       composite types. It is not used for  triggers;  use  SPI_copytuple  for
       returning a modified row in a trigger.

ARGUMENTS

       HeapTuple row
              row to be copied

       TupleDesc rowdesc
              descriptor  for row (pass the same descriptor each time for most
              effective caching)

RETURN VALUE

       HeapTupleHeader pointing to copied row; NULL only if row or rowdesc  is
       NULL

                                  2005-01-17                 SPI_returntuple()