Click above to get retro games delivered to your door ever month!

KwGetFmt, KvGetFmt

Get formatted string from the keyboard, with echo.

Header File.....TCXLinp.h

Prototype.......IntT CTYP KwGetFmt(ChrP s, ChrP f);
                IntT CTYP KvGetFmt(ChrP s, ChrP f);

Source File.....INP\KWGETFMT.C
                INP\KVGETFMT.C

Arguments.......s  -  Buffer To Receive Input String
                f  -  Format String (See Appendix D)

Returns.........ERR_NUL  -  No Error
                ERR_ARG  -  Argument Failure
                   TcxlErr contains:
                   W_NOACTIVE  -  No Active Window
                   W_ESCPRESS  -  The  Esc  Key Was Pressed
                   W_INVFORMT  -  Invalid Format String

Notes...........Inputs a formatted string from the keyboard.  Entered
                characters will be echoed to the active window using the
                current text attribute (See Appendix A), or to the Standard
                Output device.  Cursor position is updated.  Escape
                checking is provided by default, but can be turned off with
                the WsetEsc() function.

                These functions provide an extremely powerful method of
                accept single-line input from the user.  You can limit
                input characters to certain characters of a type, such as
                numbers, insert strings in between typed in characters,
                create custom prompts, disable  Enter  until the field is
                filled, and more.

                Using these functions is virtually the same as creating a
                single-field entry form, in the Entry System.  These
                functions use the same primitives, but provide a convenient
                access to the high-level formatting routines.