Next: , Previous: , Up: The Record Library   [Index]


11.4.5 Byte Data Record Search Functions

The byte data record search functions are possibly faster variants of the intrinsic text record search functions, as they don’t create new objects/values.

All functions storing mapped data link it if allowed, copy it otherwise.

rc_first

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).

rc_last

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 (first mapped key).

rcsd_greater

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.

rcsd_less

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.

rcsd_lower

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.

rcsd_upper

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.

rcsi_greater

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.

rcsi_less

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.

rcsi_lower

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.

rcsi_upper

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.

rcsik_greater

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.

rcsik_less

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.

rcsik_lower

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.

rcsik_upper

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: , Previous: , Up: The Record Library   [Index]