For cursors that return row data, these interfaces are provided for accessing

those results:

This method name is borrowed from `file` objects, and are semantically

similar. However, this being a cursor, rows are returned instead of bytes or

characters. When the number of rows returned is less then the quantity

Like, ``seek()``, the ``direction`` *property* on the cursor object effects

this method.

When the cursor is scrollable, this seek interface can be used to move the

position of the cursor. See `Scrollable Cursors`_ for more information.

This fetches the next row in the cursor object. Cursors support the iterator

protocol. While equivalent to ``cursor.read(1)[0]``, `StopIteration` is raised

if the returned sequence is empty. (``__next__()``)

For cursors opened using ``cursor_from_id()``, this method must be called in

order to ``CLOSE`` the cursor. For cursors created by invoking a prepared

statement, this is not necessary as the garbage collection interface will take

the appropriate steps.

Create a new cursor object based on the same factors that were used to

create ``c``.

By default, the `msghook` attribute does not exist. If set to a callable, any

message that occurs during an operation of the cursor will be given to the

callable. See the `Database Messages`_ section for more information.

Cursors have some additional configuration properties that may be modified

during the use of the cursor:

A value of `True`, the default, will cause read to fetch forwards, whereas a

value of `False` will cause it to fetch backwards. ``'BACKWARD'`` and

``'FORWARD'`` can be used instead of `False` and `True`.

Cursors normally share metadata with the statements that create them, so it is

usually unnecessary for referencing the cursor's column descriptions directly.

However, when a cursor is opened from an identifier, the cursor interface must

collect the metadata itself. These attributes provide the metadata in absence of

a statement object:

A sequence of SQL type names specifying the types of the columns produced by

the cursor. `None` if the cursor does not return row-data.

A sequence of PostgreSQL type Oid's specifying the types of the columns produced by

the cursor. `None` if the cursor does not return row-data.

A sequence of Python types that the cursor will produce.

A sequence of `str` objects specifying the names of the columns produced by

the cursor. `None` if the cursor does not return row-data.

The statement that was executed that created the cursor. `None` if

unknown--``db.cursor_from_id()``.