TRANSFER(SOURCE, MOLD, SIZE)

Purpose

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

It performs a low-level conversion between types without any sign extension, rounding, blank padding, or other alteration that may occur using other methods of conversion.

Class

Transformational function

Argument type and attributes

SOURCE

is the data entity whose bitwise value you want to transfer to a different type. It may be of any type, and may be a scalar or an array.

MOLD

is a data entity that has the type characteristics you want for the result. If MOLD is a variable, the value does not need to be defined. It may be of any type, and may be a scalar or an array. Its value is not used, only its type characteristics.

SIZE (optional)

is the number of elements for the output result. It must be a scalar integer. The corresponding actual argument must not be an optional dummy argument.

Result type and attributes

The same type and type parameters as MOLD.

If MOLD is a scalar and SIZE is absent, the result is a scalar.

If MOLD is array valued and SIZE is absent, the result is array valued and of rank one, with the smallest size that is physically large enough to hold SOURCE.

If SIZE is present, the result is array valued of rank one and size SIZE.

Result value

The physical representation of the result is the same as SOURCE, truncated if the result is smaller or with an undefined trailing portion if the result is larger.

      REAL(4) X /3.141/
      DOUBLE PRECISION I, J(6) /1,2,3,4,5,6/

! Because x is transferred to a larger representation
! and then back, its value is unchanged.
      X = TRANSFER( TRANSFER( X, I ), X )

! j is transferred into a real(4) array large enough to
! hold all its elements, then back into an array of
! its original size, so its value is unchanged too.
      J = TRANSFER( TRANSFER( J, X ), J, SIZE=SIZE(J) )