Platform

x64, Win32, .NET

Purpose

To change the type and/or kind type of a scalar or array.

Class

Transformational function.

Syntax

FUNCTION TRANSFER (SOURCE, MOLD [, SIZE])
INTEGER SIZE

Description

This function returns a result with a physical representation identical to that of SOURCE but interpreted with the type and type parameters of MOLD.

SOURCE and MOLD may be of any type and may be scalar or array valued. SIZE is a scalar giving the size of the result. The result is of the same type and type parameters as MOLD.

Case (i): If MOLD is a scalar and SIZE is absent, the result is a scalar.

Case (ii): If MOLD is array valued and SIZE is absent, the result is array valued and of rank one. Its size is as small as possible such that its physical representation is not shorter than that of SOURCE.

Case (iii): If SIZE is present, the result is array valued of rank one and size SIZE.

Return value

If the physical representation of the result has the same length as that of SOURCE, the physical representation of the result is that of SOURCE. If the physical representation of the result is longer than that of SOURCE, the physical representation of the leading part is that of SOURCE and the remainder is undefined. If the physical representation of the result is shorter than that of SOURCE, the physical representation of the result is the leading part of SOURCE. If D and E are scalar variables such that the physical representation of D is as long as or longer than that of E, the value of TRANSFER(TRANSFER(E, D), E) shall be the value of E.