Previous: NF_PUT_VLEN_ELEMENT, Up: Variable Length Array


5.7.5 Set a Variable Length Array with NF_GET_VLEN_ELEMENT

Use this to set the element of the (potentially) n-dimensional array of VLEN. That is, this sets the data in one variable length array.

Usage

     INTEGER FUNCTION NF_GET_VLEN_ELEMENT(INTEGER NCID, INTEGER XTYPE,
             CHARACTER*(*) VLEN_ELEMENT, INTEGER LEN, DATA)
NCID
The ncid of the file that contains the VLEN type.
XTYPE
The type of the VLEN.
VLEN_ELEMENT
The VLEN element to be set.
LEN
This will be set to the number of entries in this array.
DATA
The data will be copied here. Sufficient storage must be available or bad things will happen to you.

Errors

NF_NOERR
No error.
NF_EBADTYPE
Can't find the typeid.
NF_EBADID
ncid invalid.
NF_EBADGRPID
Group ID part of ncid was invalid.

Example

This example is from nf_test/ftst_vars4.F.

     C     Read the vlen attribute.
           retval = nf_get_att(ncid, NF_GLOBAL, 'att1', vlen_in)
           if (retval .ne. nf_noerr) call handle_err(retval)
     
     C     Get the data from the vlen we just read.
           retval = nf_get_vlen_element(ncid, vlen_typeid, vlen_in,
          &     vlen_len_in, data1_in)
           if (retval .ne. nf_noerr) call handle_err(retval)