---
name: "SPI_cursor_find"
section: "3"
platform: "linux"
package: "postgresql"
version: "18.6-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/SPI_cursor_find"
---

# SPI\_cursor\_find(3)

find an existing cursor by name

## NAME

SPI\_cursor\_find - find an existing cursor by name

## SYNOPSIS

```
Portal SPI_cursor_find(const char * name)
```

## DESCRIPTION

**SPI\_cursor\_find** finds an existing portal by name. This is primarily useful to resolve a cursor name returned as text by some other function.

## ARGUMENTS

const char \* *name*

name of the portal

## RETURN VALUE

pointer to the portal with the specified name, or NULL if none was found

## NOTES

Beware that this function can return a Portal object that does not have cursor-like properties; for example it might not return tuples. If you simply pass the Portal pointer to other SPI functions, they can defend themselves against such cases, but caution is appropriate when directly inspecting the Portal.