Skip Headers
Oracle® Database PL/SQL Language Reference
11g Release 2 (11.2)

Part Number E17126-03
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

Cursor FOR LOOP Statement

The cursor FOR LOOP statement implicitly declares its loop index as a record variable of the row type that a specified cursor returns and opens a cursor. With each iteration, the cursor FOR LOOP statement fetches a row from the result set into the record. When there are no more rows to fetch, the cursor FOR LOOP statement closes the cursor. The cursor also closes if a statement inside the loop transfers control outside the loop or if PL/SQL raises an exception.

Topics:

Syntax

cursor_for_loop_statement ::=

cursor_for_loop_statement
Description of the illustration cursor_for_loop_statement.gif

See "statement ::=".

Semantics

record_name

An identifier for the loop index that the cursor FOR LOOP statement implicitly declares as a %ROWTYPE record variable of the type that cursor_name or select_statement returns.

The variable record_name is local to the cursor FOR LOOP statement. Statements inside the loop can reference record_name and its fields. They can reference calculated columns only by aliases. Statements outside the loop cannot reference record_name. After the cursor FOR LOOP statement runs, record_name is undefined.

cursor_name

The name of an explicit cursor that is not open when the cursor FOR LOOP is entered.

actual_cursor_parameter

An actual parameter that corresponds to a formal parameter of the explicit cursor cursor_name. For more information, see "Explicit Cursors that Accept Parameters".

select_statement

A SQL SELECT statement (not a PL/SQL SELECT INTO statement). For this SELECT statement, PL/SQL declares, opens, fetches from, and closes an implicit cursor. However, because select_statement is not an independent statement, the implicit cursor is internal—you cannot reference it with the name SQL.

See Also:

Oracle Database SQL Language Reference for SELECT statement syntax

label

A label that identifies cursor_for_loop_statement (see "statement ::=" and "label"). CONTINUE, EXIT, and GOTO statements can reference this label.

Labels improve readability, especially when LOOP statements are nested, but only if you ensure that the label in the END LOOP statement matches a label at the beginning of the same LOOP statement (the compiler does not check).

Examples

Related Topics

In this chapter:

In other chapters: