Function ntcore_sys::NT_GetValueStringArray [] [src]

pub unsafe extern "C" fn NT_GetValueStringArray(
    value: *const NT_Value,
    last_change: *mut u64,
    arr_size: *mut usize
) -> *mut NT_String

Returns a copy of the NT_String array from the NT_Value. If the NT_Value is null, or is assigned to a different type, returns null.

@param value NT_Value struct to get the NT_String array from @param last_change returns time in ms since the last change in the value @param arr_size returns the number of elements in the array @return pointer to the NT_String array, or null if error

It is the caller's responsibility to free the array once its no longer needed. The NT_FreeStringArray() function is useful for this purpose. The returned array is a copy of the array in the value, and must be freed seperately. Note that the individual NT_Strings should not be freed, but the entire array should be freed at once. The NT_FreeStringArray() function will free all the NT_Strings.