invert_array_c

	status.i4.v = invert_array_c(array.g.v, num_entries.i4.v,
				     sizeof_entry.i4.v [,out_array.g.v])

	This routine will invert the order of an array.

	array		array to be manipulated
	num_entries	number of entries in the array (>= 1)
	sizeof_entry	size of a single entry (in bytes) (>= 1)
	[out_array]	output array  (Note: If this argument is specified,
			it receives the inverted array and the original
			array is left unchanged.)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid number of entries or size of entry
	CLIB_MEMFAIL		failed in allocating dynamic memory

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	insert_in_array_c, delete_from_array_c, delete_multiple_from_array_c,
	array_fill_c, array_clear_c, array_delete_duplicates_c,
	array_delete_entries_c, delete_value_from_array_c

	C/C++ usage:

	int	status;
	int	array[256];
	int	num_entries = 256;
	int	sizeof_entry = sizeof(int);
	int	out_array[256];

	status = invert_array_c((void *) array,num_entries,sizeof_entry,
				(void *) out_array);