getstr

SYNOPSIS

   #include <ocurses.h>
   

   int getstr(str)
   char str;

• getstr reads characters and stores them in a buffer until a RETURN, <NL>, or <ENTER> is received from stdscr. getstr does not check for buffer overflow.

• The characters read and stored are in a character string.

• getstr is a macro; it calls getch to read each character.

• getstr returns ERR if getch returns ERR to it. Otherwise it returns COK.

• See the discussions of echo, noecho, cbreak, nocbreak, raw, noraw, halfdelay, nodelay, and keypad below and in ETI curses(3ocurses).

EXAMPLE

   #include <ocurses.h>
   

   main()
   {
   char str[256];
   

      initscr();
      cbreak();
          /* Explained later in the section "Input Options" */
      addstr("Enter a character string terminated by <Return>:\n\n");
      refresh();
      getstr(str);
      printw("\n\n\nThe string entered was \n'%s'\n", str);
      refresh();
      endwin();
   }

Assume you entered the string 'I enjoy learning about the UNIX system'. The final screen (after entering RETURN) would appear as follows:

   Enter a character string terminated by <Return>:
   

   I enjoy learning about the UNIX system.
   

   

   The string entered was
   ´I enjoy learning about the UNIX system.'
   

   $[]