POINTERADD Function

Purpose

Increments (or decrements) a pointer value by an integer value.

Syntax

POINTERADD(x,y)

Abbreviation(s): PTRADD for POINTERADD.

Parameters

x is a pointer expression. y is a fixed binary(31) value or a value that can be converted to a fixed binary(31) value.

Description

The POINTERADD function returns a pointer value that is the pointer value x incremented by y bytes (or decremented by y bytes if y is negative).

Examples

DECLARE A CHAR(10) BASED INIT('0123456789');
DECLARE B CHAR(3); 
DECLARE P POINTER; 
ALLOCATE A SET(P); 
B = POINTERADD(P,3)->A;   /* This yields B = '345'. */

Restrictions

None.