gstream-set_input_approver man page



#include <gstream.h>

void set_input_approver(bool (*input_approver)(int));


The function handed over will be called with every new character inputted and determines whether the character will be accepted by the inputter. If it returns true, the character is accepted and inserted in the input string, if false, the character is thrown away.

A short example:

bool ia_abc_is_what_we_want(int chr)
  if (chr == 'a' || chr == 'b' || chr == 'c')
    return true;
    return false;


gs >> my_string; // the user is only able to input a, b or c

If you want to declare any variables of the type of the function, the typedef 'input_approver' in 'gbuf' makes it easy, e.g.

gbuf::input_approver tmp_ap;


tmp_ap = gs1.get_input_approver();

Note that a default input string as entered by set_input_string is not checked by this function. The default approver is 'ia_allow_everything'.

See Also

gstream-save_input_approver(3), gstream-restore_input_approver(3), gstream-get_input_approver(3), gstream-set_input_string(3), gstream-ia_allow_everything(3)

Referenced By

gstream-get_input_approver(3), gstream-restore_input_approver(3), gstream-save_input_approver(3), gstream-set_input_error_handler(3).

Explore man page connections for gstream-set_input_approver(3).

gstream version 1.6 gstream manual