menupattern(3X) menupattern(3X)

NAME
       mmeennuuppaatttteerrnn - get and set a menu's pattern buffer

SYNOPSIS
       ##iinncclluuddee <>
       int setmenupattern(MENU *menu, const char *pattern);
       char *menupattern(const MENU *menu);

DESCRIPTION
       Every  menu  has  an  associated pattern match buffer.  As input events
       that are printable ASCII characters come in, they are appended to  this
       match buffer and tested for a match, as described in mmeennuuddrriivveerr(3X).

       The  function  sseettmmeennuuppaatttteerrnn  sets  the pattern buffer for the given
       menu and tries to find the first matching item.  If it  succeeds,  that
       item becomes current; if not, the current item does not change.

       The function mmeennuuppaatttteerrnn returns the pattern buffer of the given menu.

RREETTUURRNN VVAALLUUEE
       The  function  mmeennuuppaatttteerrnn  returns  NNUULLLL  on  error.   The   function
       sseettmmeennuuppaatttteerrnn may return the following error codes:

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

       EEBBAADDAARRGGUUMMEENNTT
            Routine detected an incorrect or out-of-range argument.

       EENNOOMMAATTCCHH
            Character failed to match.

SEE ALSO
       ccuurrsseess(3X), mmeennuu(3X).

NNOOTTEESS
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PPOORRTTAABBIILLIITTYY
       These routines emulate the System V menu library.  They were  not  sup-
       ported on Version 7 or BSD versions.

AUTHORS       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                              menupattern(3X)