Programmer Guide > Creating an OPI Option > wvh_list_append
  

wvh_list_append
Appends new elements to an existing PV-WAVE LIST variable.
C Usage
long wvh_list_append(list_wvh, wvh_array, n_new)
WVH list_wvh 
WVH *wvh_array 
int n_new
Input Parameters
list_wvh—A PV-WAVE variable handle for an existing PV-WAVE LIST variable to which the new elements will be appended.
wvh_array—An array of variable handles for existing PV-WAVE variables to append to the LIST.
n_new—The number of new elements to append to the LIST.
Returned Status
OPI_SUCCESS—Successful assignment occurred.
OPI_FAILURE—The arguments are invalid or inconsistent.
OPI_DO_NOT_PROCEED—Catastrophic errors occurred and execution should not continue. The calling C-code should do its cleaning up (free malloc’s space, free handles, etc.) and return to its caller immediately.
Discussion
The PV-WAVE LIST variable you wish to modify must already exist in your PV-WAVE session, either retrieved by your C routine or created by wave_assign_list.
The new LIST elements must also exist in your PV-WAVE session, either retrieved by your C routine or created using the wave_assign_* routines.
The new LIST elements are appended to the LIST in the order they appear in the wvh_array.
wvh_list_replace currently supports only the C language interface.
For more information and example usage, see the example OPI in the wave/demo/interapp/opilist-1_0 directory.
For more general information about creating PV-WAVE variables in your C routine, see the documentation for the wave_assign_* routines.

Version 2017.0
Copyright © 2017, Rogue Wave Software, Inc. All Rights Reserved.