Next: Data Type Specific Record Functions, Previous: Record Search Functions, Up: The Record Library [Index]
The byte data record search functions are possibly faster variants of the intrinsic string record search functions, as they don’t create new objects/values.
All functions retrieving data link it if allowed, copy it otherwise.
integer rc_first(record r, data d);
is zero if the r record is empty, non zero otherwise. In the latter case d is set to the first position (first mapped key).
integer rc_last(record r, data d);
is zero if the r record is empty, non zero otherwise. In the latter case d is set to the last position (last mapped key).
integer rcs_first(&, record r, data d);
is zero if the r record is empty, non zero otherwise. In the latter case d is set to the first position (first mapped key) and the first argument to its associated data.
integer rcs_last(&, record r, data d);
is zero if the r record is empty, non zero otherwise. In the latter case d is set to the last position (last mapped key) and the first argument to its associated data.
integer rcsd_greater(&, record r, data d);
is zero if the r record defines no position (maps no key) after d, non zero otherwise. In the latter case the first argument is set to the data associated with the first after position.
integer rcsd_less(&, record r, data d);
is zero if the r record defines no position (maps no key) before d, non zero otherwise. In the latter case the first argument is set to the data associated with the last before position.
integer rcsd_lower(&, record r, data d);
is zero if the r record defines no position (maps no key) less or equal to d, non zero otherwise. In the latter case the first argument is set to the data associated with the last not greater position.
integer rcsd_upper(&, record r, data d);
is zero if the r record defines no position (maps no key) greater or equal to d, non zero otherwise. In the latter case the first argument is set to the data associated with the first not less position.
integer rcsi_greater(&, record r, data d);
is zero if the r record defines no position (maps no key) greater than d, non zero otherwise. In the latter case d is set to the first after position and the first argument to its associated data.
integer rcsi_less(&, record r, data d);
is zero if the r record defines no position (maps no key) less than d, non zero otherwise. In the latter case d is set to the last before position and the first argument to its associated data.
integer rcsi_lower(&, record r, data d);
is zero if the r record defines no position (maps no key) matching or less than d, non zero otherwise. In the latter case d is set to the last not after position and the first argument to its associated data.
integer rcsi_upper(&, record r, data d);
is zero if the r record defines no position (maps no key) matching or greater than d, non zero otherwise. In the latter case d is set to the first not before position and the first argument to its associated data.
integer rcsik_greater(record r, data d);
is zero if the r record defines no position (maps no key) after d, non zero otherwise. In the latter case d is set to the first after position.
integer rcsik_less(record r, data d);
is zero if the r record defines no position (maps no key) before d, non zero otherwise. In the latter case d is set to the last before position.
integer rcsik_lower(record r, data d);
is zero if the r record defines no position (maps no key) matching or less than d, non zero otherwise. In the latter case d is set to the last not after position.
integer rcsik_upper(record r, data d);
is zero if the r record defines no position (maps no key) matching or greater than d, non zero otherwise. In the latter case d is set to the first not before position.
Next: Data Type Specific Record Functions, Previous: Record Search Functions, Up: The Record Library [Index]