Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- ClipOn 3.0 Reference - c_arrstr() http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 C_ARRSTR()

 DESCRIPTION

 C_ARRSTR() returns the longest character string found in the
 specified array.  The value returned may be either the array
 element of the longest string or the length of the longest string.

 NOTES

 C_ARRSTR() returns information for the first occurrence of the
 longest string found (if two strings in the array are the same length).

 Array elements that are undefined are not evaluated in the search.

 SYNTAX

 C_ARRSTR(array [,return_type])

 PARAMETERS

 array (A) is the array to determine the longest string.  The array
 argument is specified without quotes.

 return_type (N) specifies the value which should be returned.  A
 return type of 1 indicates that the length of the longest string
 should be returned.  A return type of 2 indicates that the array
 element of the longest string should be returned.  If no value is
 specified for return_type, the default of 1 is used.

 RETURNS

 C_ARRSTR() returns either the length of the longest string or the
 array element of the longest string depending on the value of the
 return_type argument.  Both values are returned as numerics.

 EXAMPLES

 private arr1[4]
 arr1[1] = "Setup"
 arr1[2] = "Backup"
 arr1[3] = "Restore"
 arr1[4] = "Exit"

 ? c_arrstr(arr1)    --> 7    && length of string (default)
 ? c_arrstr(arr1,1)  --> 7    && length of string
 ? c_arrstr(arr1,2)  --> 3    && array element of string


See Also: C_ARRCT() C_ARRMIN() C_ARRMAX() C_ARRSUM() C_ARRAVG()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson