X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_addch.3x.html;h=36e05ad613fff0cf256e82b50b63e5fd01423b99;hb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012;hp=af567118c69b4b6139f2f5dd17447fb565fae232;hpb=f86cbeb5f9bd96ab041d34039c35749a14965039;p=ncurses.git diff --git a/doc/html/man/curs_addch.3x.html b/doc/html/man/curs_addch.3x.html index af567118..36e05ad6 100644 --- a/doc/html/man/curs_addch.3x.html +++ b/doc/html/man/curs_addch.3x.html @@ -1,8 +1,7 @@ - + + + curs_addch 3x @@ -40,21 +42,20 @@

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,24 +67,38 @@
 
 
 

-
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.
+       putchar in stdio(3).  If the advance is at the right  mar-
+       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, 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.
+       appropriately within the window:
+
+       o   Backspace moves the cursor one character left; at  the
+           left edge of a window it does nothing.
+
+       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 control character other than tab, newline, or
        backspace, it is drawn  in  ^X  notation.   Calling  winch
@@ -107,14 +122,15 @@
        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
        acsc  capability  does  not  define  a   terminal-specific
-       replacement  for  it.   The  names  are  taken  from VT100
-       nomenclature.
-
+       replacement for it.  The names are taken from VT100 nomen-
+       clature.
 
        Name           Default   Description
        --------------------------------------------------
@@ -153,7 +169,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-
@@ -165,13 +181,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.
@@ -199,10 +215,10 @@
 
 
 

-
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).
+       putc(3).
 
        Comparable  functions  in  the  wide-character  (ncursesw)
        library are described in curs_add_wch(3x).
@@ -211,10 +227,20 @@
 
                                                          curs_addch(3x)
 

-

-

-Man(1) output converted with
-man2html
-

+

+
+