wvh_sizeofdata

Returns the size in bytes of the data area of a PV‑WAVE variable.

C Usage

long wvh_sizeofdata(wvh)

WVH wvh;

FORTRAN Usage

INTEGER*4 LF_WVH_SIZEOFDATA(l_wvh)

INTEGER*4 l_wvh

64-bit UNIX FORTRAN Usage

INTEGER*8 LF_WVH_SIZEOFDATA(l_wvh)

INTEGER*8 l_wvh

Input Parameters

wvh—The Wave variable handle of the variable.

Returned Values

Returns the size in bytes of the data area of the variable. Note that for scalar strings, wvh_sizeofdata returns the size of a (char *) and for string arrays, wvh_sizeofdata returns wvh_nelems*sizeof(char *). To get the length of the actual string, you must get the data pointer and use the PV‑WAVE STRLEN function or some other method of finding the length of the string pointed to by the data pointer.

On failure, –1 is returned.