Record Variable Declaration

14.54 Record Variable Declaration

A record variable is a composite variable whose internal components, called fields, can have different data types. The value of a record variable and the values of its fields can change.

You reference an entire record variable by its name. You reference a record field with the syntax record.field.

You can create a record variable in any of these ways:

Define a record type and then declare a variable of that type.
Use %ROWTYPE to declare a record variable that represents either a full or partial row of a database table or view.
Use %TYPE to declare a record variable of the same type as a previously declared record variable.

Topics

Syntax

record_type_definition ::=

Description of the illustration record_type_definition.eps

field_definition ::=

Description of the illustration field_definition.eps

( datatype ::= , expression ::= )

record_variable_declaration ::=

Description of the illustration record_variable_declaration.eps

( rowtype_attribute ::=)

Semantics

record_type_definition

record_type

Name of the record type that you are defining.

field_definition

field

Name of the field that you are defining.

datatype

Data type of the field that you are defining.

NOT NULL

Imposes the NOT NULL constraint on the field that you are defining.

For information about this constraint, see "NOT NULL Constraint".

expression

Expression whose data type is compatible with datatype. When record_variable_declaration is elaborated, the value of expression is assigned to record.field. This value is the initial value of the field.

record_variable_declaration

record_1

Name of the record variable that you are declaring.

record_type

Name of a previously defined record type. record_type is the data type of record_1.

rowtype_attribute

See "%ROWTYPE Attribute".

record_2

Name of a previously declared record variable.

%TYPE

See "%TYPE Attribute".

Examples

Example 6-41, "RECORD Type Definition and Variable Declaration"
Example 6-42, "RECORD Type with RECORD Field (Nested Record)"
Example 6-43, "RECORD Type with Varray Field"