---
title: "SPI_prepare_extended"
id: spi-spi-prepare-extended
pg_version: "20devel"
---

<a id="spi-spi-prepare-extended"></a>

# SPI_prepare_extended — prepare a statement, without executing it yet

## Synopsis

```
SPIPlanPtr SPI_prepare_extended(const char * command,
                                const SPIPrepareOptions * options)
```

<a id="id-1.8.12.8.10.5"></a>

## Description

`SPI_prepare_extended` creates and returns a prepared statement for the specified command, but doesn't execute the command. This function is equivalent to `SPI_prepare`, with the addition that the caller can specify options to control the parsing of external parameter references, as well as other facets of query parsing and planning. 

<a id="id-1.8.12.8.10.6"></a>

## Arguments

**`const char * command`**

 command string **`const SPIPrepareOptions * options`**

 struct containing optional arguments Callers should always zero out the entire `options` struct, then fill whichever fields they want to set. This ensures forward compatibility of code, since any fields that are added to the struct in future will be defined to behave backwards-compatibly if they are zero. The currently available `options` fields are: 

**`ParserSetupHook parserSetup`**

 Parser hook setup function **`void * parserSetupArg`**

 pass-through argument for `parserSetup` **`RawParseMode parseMode`**

 mode for raw parsing; `RAW_PARSE_DEFAULT` (zero) produces default behavior **`int cursorOptions`**

 integer bit mask of cursor options; zero produces default behavior <a id="id-1.8.12.8.10.7"></a>

## Return Value

`SPI_prepare_extended` has the same return conventions as `SPI_prepare`.