Next: , Previous: , Up: The Byte Data Library   [Index]


13.10.10 Byte Data Traversal Functions

bt_first

integer bt_first(integer &c, data d, integer &p);

is zero if the d byte array is empty, non zero otherwise. Sets p to 0. For non zero evaluations c is set to the character in the first position.

bt_last

integer bt_last(integer &c, data d, integer &p);

is zero if the d byte array is empty, non zero otherwise. Sets p to -1. For non zero evaluations c is set to the character in the last position.

bt_next

integer bt_next(integer &c, data d, integer &p);

is zero if the d byte array defines no position after p, non zero otherwise. Increments p. For non zero evaluations c is set to the character in the new p position.

bt_previous

integer bt_previous(integer &c, data d, integer &p);

is zero if the d byte array defines no position before p, non zero otherwise. Decrements p. For non zero evaluations c is set to the character in the new p position.