SPI_execp
Name
SPI_execp -- Executes a plan from
SPI_prepare
Synopsis
SPI_execp(plan,
values,
nulls,
tcount)
Inputs
- void *plan
-
Execution plan
- Datum *values
-
Actual parameter values
- char *nulls
-
Array describing which parameters are NULLs
| n indicates NULL (values[] entry ignored) |
| space indicates not NULL (values[] entry is valid) |
- int tcount
-
Number of tuples for which plan is to be executed
Outputs
- int
-
Returns the same value as SPI_exec as well as
| SPI_ERROR_ARGUMENT if plan is NULL or tcount < 0 |
| SPI_ERROR_PARAM if values is NULL and plan was prepared with some parameters. |
- SPI_tuptable
-
initialized as in SPI_exec if successful
- SPI_processed
-
initialized as in SPI_exec if successful
Description
SPI_execp executes a plan prepared by SPI_prepare. tcount has the same interpretation as in SPI_exec.
Usage
If nulls is NULL then SPI_execp assumes that all parameters (if any) are NOT NULL.
Note: If one of the objects (a relation, function, etc.) referenced by the prepared plan is dropped during your session (by your backend or another process) then the results of SPI_execp for this plan will be unpredictable.