GetRecords()

Gets an array of record handles for a selection set.

Added to Version 5.0.

rh_array = GetRecords(string view_set, array opts)

Argument	Contents
view_set	The view and selection set from which record handles are gotten

Option	Type	Contents
Sort Order	Array	An array of arrays, each with a field name-order pair (elements described below), indicating the desired sort order.
Start	String	The first record to be returned (defaults to the first record)
Limit	Integer	The maximum number of records to return, or -1 (the default) for all.

An array of record handles for the records in the selection set.

This is like a string array version of GetSetIDs, but it works on non-mappable views as well.

//Open BDOCUMENTS\CALIPER\\< product name>\TUTORIAL\NElayers.wrkz

tutorial_folder = RunMacro("G30 Tutorial Folder")

wrkz = OpenWorkspace(tutorial_folder + "NElayers.wrkz")

tutorial_folder = RunMacro("G30 Tutorial Folder")

wrkz = OpenWorkspace(tutorial_folder + "NElayers.wrkz")rh_array = GetRecords("Place|Selection", {{"Sort Order",{{"City", "Ascending"}}}} )

ShowArray(rh_array)

Error Type

Meaning

NotFound

The specified view or set does not exist; or

some field in the Sort Order option does not exist.

Function	Summary
GetRecord()	Gets the record handle of the current record of a view
GetSetIDs	Gets an array of the IDs of elements in a set
IsMember()	Tests whether a record is a member of a selection set.