---
title: "SPI_cursor_move"
id: spi-spi-cursor-move
pg_version: "20devel"
---

<a id="spi-spi-cursor-move"></a>

# SPI_cursor_move — move a cursor

## Synopsis

```
void SPI_cursor_move(Portal portal, bool forward, long count)
```

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

## Description

`SPI_cursor_move` skips over some number of rows in a cursor. This is equivalent to a subset of the SQL command `MOVE` (see `SPI_scroll_cursor_move` for more functionality). 

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

## Arguments

**`Portal portal`**

 portal containing the cursor **`bool forward`**

 true for move forward, false for move backward **`long count`**

 maximum number of rows to move <a id="id-1.8.12.8.25.7"></a>

## Notes

Moving backward may fail if the cursor's plan was not created with the `CURSOR_OPT_SCROLL` option.