5.6.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)
