SPI_cursor_open_with_paramlist
SPI_cursor_open_with_paramlist — set up a cursor using parameters
Synopsis
Portal SPI_cursor_open_with_paramlist(const char *name, SPIPlanPtrplan, ParamListInfoparams, boolread_only)
Description
SPI_cursor_open_with_paramlist sets up a cursor (internally, a portal) that will execute a statement prepared bySPI_prepare. This function is equivalent toSPI_cursor_open except that information about the parameter values to be passed to the query is presented differently. TheParamListInfo representation can be convenient for passing down values that are already available in that format. It also supports use of dynamic parameter sets via hook functions specified inParamListInfo.
The passed-in parameter data will be copied into the cursor's portal, so it can be freed while the cursor still exists.
Arguments
const char *namename for portal, or
NULLto let the system select a nameSPIPlanPtrplanprepared statement (returned by
SPI_prepare)ParamListInfoparamsdata structure containing parameter types and values; NULL if none
boolread_onlytruefor read-only execution
Return Value
Pointer to portal containing the cursor. Note there is no error return convention; any error will be reported viaelog.