# ingres_cursor

(PECL ingres:1.1-1.4.3)

ingres_cursor — Gets a cursor name for a given link resource

### Description

string ingres_cursor ([ resource `$link` ] )

Returns an string containing the active cursor name. If no cursor is active then NULL is returned.

If a `link` resource is passed to ingres_cursor() it returns the cursor name recorded for the link. If no link is passed then ingres_cursor() returns the cursor name asssociated with the default link.

### Parameters

`link`

  The connection link identifier. If not specified, the last opened link is used.

### Return Values

Returns an string containing the active cursor name. If no cursor is active then NULL is returned.

### Examples

Example#1 ingres_cursor() example

`<?php
$link = ingres_connect($database, $user, $password);
ingres_prepare("select * from table", $link);
$cursor_name = ingres_cursor($link);
echo $cursor_name;
?>`

### See Also

- ingres_prepare()
- ingres_execute()