X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addch.3x.html;h=39887f41f9e2e72f1e7ae54637c884aa351ff674;hb=db5f7f4f146a91ba8ec7f1df8e9d7f9d2d7c74fd;hp=b8e1fb01ed1249b8636e549671b9eabc4a0a84cb;hpb=2e5d72d6396bb38a8d1d1b3534f62e28aebaa600;p=ncurses.git diff --git a/doc/html/man/curs_addch.3x.html b/doc/html/man/curs_addch.3x.html index b8e1fb01..39887f41 100644 --- a/doc/html/man/curs_addch.3x.html +++ b/doc/html/man/curs_addch.3x.html @@ -1,8 +1,7 @@ - + + + curs_addch 3x -

curs_addch 3x

-
+

curs_addch 3x

-
 curs_addch(3x)                                           curs_addch(3x)
 
 
 
 
 
-

NAME

+

NAME

        addch,  waddch,  mvaddch,  mvwaddch, echochar, wechochar -
        add a character (with attributes) to a curses window, then
        advance the cursor
 
 
 
-

SYNOPSIS

+

SYNOPSIS

        #include <curses.h>
 
        int addch(const chtype ch);
@@ -66,30 +66,46 @@
 
 
 
-

DESCRIPTION

+

DESCRIPTION

        The  addch,  waddch, mvaddch and mvwaddch routines put the
        character ch into the given window at its  current  window
        position,  which  is then advanced.  They are analogous to
        putchar in stdio(3).  If the advance is at the right  mar-
-       gin,  the  cursor  automatically wraps to the beginning of
-       the next line.  At the bottom  of  the  current  scrolling
-       region,  if  scrollok  is enabled, the scrolling region is
-       scrolled up one line.
-
-       If ch is a tab, newline, or backspace, the cursor is moved
-       appropriately within the window.  Backspace moves the cur-
-       sor one character left; at the left edge of  a  window  it
-       does  nothing.   Newline  does  a clrtoeol, then moves the
-       cursor to  the  window  left  margin  on  the  next  line,
-       scrolling  the  window if on the last line.  Tabs are con-
-       sidered to be at every eighth column.   The  tab  interval
-       may be altered by setting the TABSIZE variable.
-
-       If ch is any control character other than tab, newline, or
-       backspace, it is drawn  in  ^X  notation.   Calling  winch
-       after adding a control character does not return the char-
-       acter itself, but instead returns the ^-representation  of
-       the control character.
+       gin:
+
+       o   The cursor automatically wraps to the beginning of the
+           next line.
+
+       o   At the bottom of the current scrolling region, and  if
+           scrollok  is enabled, the scrolling region is scrolled
+           up one line.
+
+       o   If scrollok is not enabled, writing a character at the
+           lower  right  margin  succeeds.   However, an error is
+           returned because it is not possible to wrap to  a  new
+           line
+
+       If ch is a tab, newline, carriage return or backspace, the
+       cursor is moved appropriately within the window:
+
+       o   Backspace moves the cursor one character left; at  the
+           left edge of a window it does nothing.
+
+       o   Carriage  return  moves  the cursor to the window left
+           margin on the current line.
+
+       o   Newline does a clrtoeol, then moves the cursor to  the
+           window  left  margin  on  the next line, scrolling the
+           window if on the last line.
+
+       o   Tabs are considered to be at every eighth column.  The
+           tab  interval  may  be  altered by setting the TABSIZE
+           variable.
+
+       If ch is any other control character, it is  drawn  in  ^X
+       notation.   Calling winch after adding a control character
+       does not return the character itself, but instead  returns
+       the ^-representation of the control character.
 
        Video attributes can be combined with a character argument
        passed to addch or related functions by logical-ORing them
@@ -107,7 +123,9 @@
        may be seen by  using  these  routines  instead  of  their
        equivalents.
 
-   Line Graphics
+
+
+

Line Graphics

        The  following  variables  may be used to add line drawing
        characters to the screen with routines of the  addch  fam-
        ily.   The  default  character listed below is used if the
@@ -152,7 +170,7 @@
 
 
 
-

RETURN VALUE

+

RETURN VALUE

        All routines return the integer ERR upon failure and OK on
        success  (the  SVr4 manuals specify only "an integer value
        other than ERR") upon successful completion, unless other-
@@ -164,13 +182,13 @@
 
 
 
-

NOTES

+

NOTES

        Note  that  addch,  mvaddch, mvwaddch, and echochar may be
        macros.
 
 
 
-

PORTABILITY

+

PORTABILITY

        All these functions are described in the XSI Curses  stan-
        dard,  Issue  4.  The defaults specified for forms-drawing
        characters apply in the POSIX locale.
@@ -198,7 +216,7 @@
 
 
 
-

SEE ALSO

+

SEE ALSO

        curses(3x),  curs_attr(3x), curs_clear(3x), curs_inch(3x),
        curs_outopts(3x),  curs_refresh(3x),   curs_variables(3x),
        putc(3).
@@ -210,10 +228,20 @@
 
                                                          curs_addch(3x)
 
-
-
-Man(1) output converted with -man2html -
+