InterCall Developer's Guide - Rocket Software

InterCall Developer's Guide - Rocket Software InterCall Developer's Guide - Rocket Software

rocketsoftware.com
from rocketsoftware.com More from this publisher
03.03.2013 Views

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

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

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!