InterCall Developer's Guide - Rocket Software
InterCall Developer's Guide - Rocket Software InterCall Developer's Guide - Rocket Software
ic_locate Syntax 3-65 InterCall Developer’s Guide ic_locate (search, search_len, dynamic_array, dynamic_len, field, value, start, order, order_len, index, found, code) Input Variables The following table describes the input variables. Parameter Type Description search char * Content of the field, value, or subvalue being sought. search_len long * Length of the search string. dynamic_array char * Dynamic array to be searched. dynamic_len long * Length of the dynamic array. field long * Starting field position for the search. value long * Starting value position for the search. start long * Field or value from which to start the search. order char * String indicating the order of the elements within the dynamic array. order_len long * Length of order is as follows: AL or A = Ascending, left-justified AR = Ascending, right-justified D = Descending, left-justified DR = Descending, right-justified ic_locate Input Variables
Output Variables The following table describes the output variables. Parameter Type Description index long * A variable to receive the position within the dynamic array of the string being sought. found long * Either 1 if search was found or 0 if it was not. code long * Either 0 if execution was successful or a specific error code if execution was not successful. ic_locate Output Variables Description ic_locate searches a dynamic array for a string and returns a value indicating whether the expression is in the array and where it is or where the expression should go if it is not in the array. ic_locate searches the dynamic array for search and returns values indicating the following: Where search was found in the dynamic array Where search should be inserted in the dynamic array if it was not found The search can start anywhere in dynamic_array. field and value delimiter values specify: Where the search is to start in the dynamic array What kind of element is being searched for Related Functions ic_extract ic_insert ic_replace ic_strdel ic_locate 3-66
- Page 47 and 48: ic_clearselect Syntax ic_clearselec
- Page 49 and 50: ic_close Syntax ic_close (file_id,
- Page 51 and 52: ic_closeseq Syntax ic_closeseq (fil
- Page 53 and 54: ic_data Syntax ic_data (string, str
- Page 55 and 56: ic_date Syntax ic_date (date, code)
- Page 57 and 58: Output Variables The following tabl
- Page 59 and 60: Output Variables The following tabl
- Page 61 and 62: Description ic_executecontinue lets
- Page 63 and 64: Description ic_extract returns data
- Page 65 and 66: Description ic_fileinfo returns a s
- Page 67 and 68: ic_filelock Syntax ic_filelock (fil
- Page 69 and 70: ic_fileunlock Syntax ic_fileunlock
- Page 71 and 72: ic_fmt Syntax ic_fmt (format, forma
- Page 73 and 74: ic_formlist Syntax ic_formlist (dyn
- Page 75 and 76: ic_free Syntax ic_free (ptr) Input
- Page 77 and 78: Related Functions ic_clearselect ic
- Page 79 and 80: Description Note: UniData databases
- Page 81 and 82: If NLS mode is not enabled on the s
- Page 83 and 84: Description Note: UniData databases
- Page 85 and 86: The following table lists the valid
- Page 87 and 88: ic_iconv Syntax ic_iconv (conv, con
- Page 89 and 90: ic_indices Syntax ic_indices (file_
- Page 91 and 92: Related Function ic_selectindex ic_
- Page 93 and 94: Output Variables The following tabl
- Page 95 and 96: Output Variable The following table
- Page 97: Output Variables The following tabl
- Page 101 and 102: ic_lower Syntax ic_lower (string, s
- Page 103 and 104: ic_malloc Syntax ptr = ic_malloc (s
- Page 105 and 106: Parameter Type Description Descript
- Page 107 and 108: Description ic_open opens a server
- Page 109 and 110: ic_openseq Syntax ic_openseq (file_
- Page 111 and 112: ic_opensession Syntax session_id =
- Page 113 and 114: If you enter server_name:port_numbe
- Page 115 and 116: ic_quitall Syntax ic_quitall (code)
- Page 117 and 118: Description ic_raise returns string
- Page 119 and 120: Parameter Type Description Descript
- Page 121 and 122: ic_readblk Syntax ic_readblk (file_
- Page 123 and 124: ic_readlist Syntax ic_readlist (sel
- Page 125 and 126: ic_readnext Syntax ic_readnext (sel
- Page 127 and 128: ic_readseq Syntax ic_readseq (file_
- Page 129 and 130: ic_readv Syntax ic_readv (file_id,
- Page 131 and 132: IK_READU: If a value of IK_READUW o
- Page 133 and 134: Output Variables The following tabl
- Page 135 and 136: ic_recordlocked Syntax ic_recordloc
- Page 137 and 138: Related Functions ic_clearfile ic_d
- Page 139 and 140: If the value of file_id is 0, ic_re
- Page 141 and 142: Output Variables The following tabl
- Page 143 and 144: ic_replace Syntax ic_replace (dynam
- Page 145 and 146: Related Functions ic_extract ic_ins
- Page 147 and 148: Description Note: UniData databases
Output Variables<br />
The following table describes the output variables.<br />
Parameter Type Description<br />
index long * A variable to receive the position within the dynamic array of<br />
the string being sought.<br />
found long * Either 1 if search was found or 0 if it was not.<br />
code long * Either 0 if execution was successful or a specific error code<br />
if execution was not successful.<br />
ic_locate Output Variables<br />
Description<br />
ic_locate searches a dynamic array for a string and returns a value indicating whether<br />
the expression is in the array and where it is or where the expression should go if it<br />
is not in the array. ic_locate searches the dynamic array for search and returns values<br />
indicating the following:<br />
Where search was found in the dynamic array<br />
Where search should be inserted in the dynamic array if it was not found<br />
The search can start anywhere in dynamic_array. field and value delimiter values<br />
specify:<br />
Where the search is to start in the dynamic array<br />
What kind of element is being searched for<br />
Related Functions<br />
ic_extract<br />
ic_insert<br />
ic_replace<br />
ic_strdel<br />
ic_locate 3-66