---

Manual Reference Pages  - unpack (3)

---

NAME

unpack(3f) - [FORTRAN:INTRINSIC:ARRAY CONSTRUCTION] Store the elements of a vector in an array of higher rank

CONTENTS

Syntax
Description
Arguments
Return Value
Example
Standard
Class
See Also

SYNTAX

result = unpack(vector, mask, field)

DESCRIPTION

Store the elements of VECTOR in an array of higher rank.

ARGUMENTS

VECTOR	- Shall be an array of any type and rank one. It shall have at least as many elements as MASK has TRUE values.
MASK	- Shall be an array of type LOGICAL.
FIELD	- Shall be of the same type as VECTOR and have the same shape as MASK.

RETURN VALUE

The resulting array corresponds to FIELD with TRUE elements of MASK replaced by values from VECTOR in array element order.

EXAMPLE

Sample program:

    program demo_unpack
      integer :: vector(2)  = (/1,1/)
      logical :: mask(4)  = (/ .true., .false., .false., .true. /)
      integer :: field(2,2) = 0, unity(2,2)

      ! result: unity matrix
      unity = unpack(vector, reshape(mask, (/2,2/)), field)
    end program demo_unpack

STANDARD

Fortran 95 and later

CLASS

Transformational function

SEE ALSO

[[pack]], [[spread]]

---

unpack (3)

March 19, 2019

Generated by manServer 1.08 from 5ee5aa2d-41c7-4361-b58f-5e19741fd56d using man macros.