---

G.3.8 Searching values ¶

For the semantics of the parameter ARRY see Conventions of the arrays API. For the semantics of the parameter ISEQUAL see Conventions of the arrays API. For the semantics of the parameter PRED see Conventions of the arrays API.

Function: mbfl_array_find_left_slot_containing_value_var IDX_RV ARRY VALUE ¶

Function: mbfl_array_find_left_slot_containing_value_var IDX_RV ARRY VALUE ISEQUAL ¶

Function: mbfl_array_find_right_slot_containing_value_var IDX_RV ARRY VALUE ¶

Function: mbfl_array_find_right_slot_containing_value_var IDX_RV ARRY VALUE ISEQUAL ¶

Search ARRY for the leftmost/rightmost slot containing a value equal to VALUE according to ISEQUAL. When found: store slot’s index in IDX_RV and return true; otherwise return false.

#                                      0 1 2  3 4 5 6  7 8 9
mbfl_declare_index_array_varref(ARRY, (a b c 99 d e f 99 g h))
mbfl_declare_integer_varref(IDX)

mbfl_array_find_left_slot_containing_value_var  _(IDX) _(ARRY) 99  ⇒ 0
$IDX    ⇒ 3

mbfl_array_find_right_slot_containing_value_var _(IDX) _(ARRY) 99  ⇒ 0
$IDX    ⇒ 7

Function: mbfl_array_find_left_slot_containing_value ARRY VALUE ¶

Function: mbfl_array_find_left_slot_containing_value ARRY VALUE ISEQUAL ¶

Function: mbfl_array_find_right_slot_containing_value ARRY VALUE ¶

Function: mbfl_array_find_right_slot_containing_value ARRY VALUE ISEQUAL ¶

Like the functions above, but do not retrieve slot’s index.

Function: mbfl_array_find_left_slot_satisfying_pred_var IDX_RV ARRY PRED ¶

Function: mbfl_array_find_right_slot_satisfying_pred_var IDX_RV ARRY PRED ¶

Search ARRY for the leftmost/rightmost slot containing a value satisfying PRED. When found: store slot’s index in IDX_RV and return true; otherwise return false.

function pred () {
    mbfl_mandatory_parameter(VALUE, 1, value)
    mbfl_string_equal "$VALUE" '99'
}

#                                      0 1 2  3 4 5 6  7 8 9
mbfl_declare_index_array_varref(ARRY, (a b c 99 d e f 99 g h))
mbfl_declare_integer_varref(IDX)

mbfl_array_find_left_slot_satisfying_pred_var  _(IDX) _(ARRY) pred   ⇒ 0
$IDX    ⇒ 3

mbfl_array_find_right_slot_satisfying_pred_var _(IDX) _(ARRY) pred   ⇒ 0
$IDX    ⇒ 7

Function: mbfl_array_find_left_slot_satisfying_pred ARRY VALUE PRED ¶

Function: mbfl_array_find_right_slot_satisfying_pred ARRY VALUE PRED ¶

Like the functions above, but do not retrieve slot’s index.