Programming Guide - Actian

ArraysThe format parameter can be any of the legal OpenROAD format templates forthe attribute type for which you are searching. For a list of the formattemplates, see the User Guide. For more information about specifying theformat parameter, see the Language Reference Guide online help. If theformat attribute is omitted, the default format is used for the specifiedattribute type.If the Find method finds a row, the rownumber parameter (if specified) is setto the row number of the found row. Table fields displaying the array are notautomatically scrolled to the row found. To move the input focus to this row,you must write your own 4GL code, using SetInput Focus method on the tablefield.The other parameters for the Find method are:casesensitiveSpecifies whether case is significantDefault: TRUEusedeletedSpecifies whether to search through deleted rowsDefault: FALSEstartrowAlways specifies a positive number unless usedeleted is TRUE, in whichcase startrow defaults to array.FirstRowDefault: 1EndrowAlways specifies a positive number unless usedeleted is TRUE. If endrow isless than startrow, the search wrapsDefault: array.LastRowThe value of status is one of the following:ER_OKSpecifies that the row was foundER_ROWNOTFOUNDSpecifies that the row was not foundER_FAILSpecifies that the search failed. Failure is caused problems such asattempting to compare incompatible data types or specifying incorrectattributes.226 Programming Guide