RCDATA

nameID RCDATA [load-option] [mem-option]
BEGIN
raw-data
.
.
.
END

The RCDATA statement defines a raw data resource for an application. Raw data resources permit the inclusion of binary data directly in the executable file.

Parameters

nameID

Specifies either a unique name or an integer value that identifies the resource.

load-option

Specifies when the resource is to be loaded. It takes one of the following keywords:

Option

Description

PRELOAD	Resource is loaded immediately.
LOADONCALL	Resource is loaded when called. This is the default option.

mem-option

Specifies whether the resource is fixed or movable and whether it is discardable. This optional parameter takes one or more of the following keywords:

Option

Description

FIXED	Resource remains at a fixed memory location.
MOVEABLE	Resource can be moved if necessary in order to compact memory.
DISCARDABLE	Resource can be discarded if no longer needed.

The default memory option is MOVEABLE and DISCARDABLE.

raw-data

Specifies one or more integers and strings. Integers can be in decimal, octal, or hexadecimal format.

Examples

The following example demonstrates the usage of the RCDATA statement:

resname RCDATA
BEGIN
   "Here is a data string\0", /* A string. Note: explicitly
                                 null-terminated */
   1024,                  /* int        */
   0x029a,                /* hex int    */
   0o733,                 /* octal int  */
   "\07"                  /* octal byte */
END