---

Manual Reference Pages  - unpack (3)

---

NAME

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

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
    implicit none
      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(3), spread(3)

---

unpack (3)

March 11, 2021

Generated by manServer 1.08 from 0d7f0373-103b-44c8-9e43-44ee661820a7 using man macros.