scanw(3ncurses)


NAME

   scanw, wscanw, mvscanw, mvwscanw, vwscanw, vw_scanw - convert formatted
   input from a curses window

SYNOPSIS

   #include <curses.h>

   int scanw(char *fmt, ...);
   int wscanw(WINDOW *win, char *fmt, ...);
   int mvscanw(int y, int x, char *fmt, ...);
   int mvwscanw(WINDOW *win, int y, int x, char *fmt, ...);
   int vw_scanw(WINDOW *win, char *fmt, va_list varglist);
   int vwscanw(WINDOW *win, char *fmt, va_list varglist);

DESCRIPTION

   The scanw, wscanw and mvscanw routines  are  analogous  to  scanf  [see
   scanf(3)].   The  effect  of  these  routines is as though wgetstr were
   called on the  window,  and  the  resulting  line  used  as  input  for
   sscanf(3).   Fields which do not map to a variable in the fmt field are
   lost.

   The vwscanw and  vw_scanw  routines  are  analogous  to  vscanf.   They
   perform a wscanw using a variable argument list.  The third argument is
   a va_list, a pointer to a list of arguments, as defined in <stdarg.h>.

RETURN VALUE

   vwscanw returns ERR on failure and an integer equal to  the  number  of
   fields scanned on success.

   Applications  may  use the return value from the scanw, wscanw, mvscanw
   and mvwscanw routines to determine the  number  of  fields  which  were
   mapped in the call.

   Functions  with  a  "mv"  prefix  first perform a cursor movement using
   wmove, and return an error if the position is outside the window, or if
   the window pointer is null.

PORTABILITY

   The  XSI  Curses  standard,  Issue  4  describes  these functions.  The
   function vwscanw is marked TO BE WITHDRAWN, and is to be replaced by  a
   function  vw_scanw  using  the  <stdarg.h>  interface.  The Single Unix
   Specification, Version 2 states that vw_scanw  is preferred to  vwscanw
   since  the  latter requires including <varargs.h>, which cannot be used
   in the same file as <stdarg.h>.  This  implementation  uses  <stdarg.h>
   for both, because that header is included in <curses.h>.

   Both  XSI and The Single Unix Specification, Version 2 state that these
   functions return ERR or OK.  Since the underlying scanf can return  the
   number  of  items scanned, and the SVr4 code was documented to use this
   feature, this is probably an editing error which was introduced in XSI,
   rather  than  being  done  intentionally.  Portable applications should
   only test if the return value is ERR, since  the  OK  value  (zero)  is
   likely  to be misleading.  One possible way to get useful results would
   be to use a "%n" conversion at the end of the format string  to  ensure
   that something was processed.

SEE ALSO

   ncurses(3NCURSES), getstr(3NCURSES), printw(3NCURSES), scanf(3)

                                                           scanw(3NCURSES)





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.