Return to lputchar.3l CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / p_man / man3

Annotation of researchv10dc/630/man/src/p_man/man3/lputchar.3l, revision 1.1.1.1

1.1       root        1: .TH LPUTCHAR 3L "630 MTG"
                      2: .SH NAME
                      3: lputchar \- 630 MTG local putchar function
                      4: .SH SYNOPSIS
                      5: .ft B
                      6: void lputchar (c)
                      7: .br
                      8: \f3char c; \f1
                      9: .ft R
                     10: .SH DESCRIPTION
                     11: \fILputchar\fR is
                     12: syntactically equivalent to the UNIX standard I/O putchar function.
                     13: It can be called by downloaded application programs who
                     14: want to display characters within their window on the 630 MTG screen.
                     15: Where (within the applications window) characters are displayed can be
                     16: affected with the \fImoveto\fR(3L) function.
                     17: .I Lputchar
                     18: calls the
                     19: .I moveto
                     20: routine to update the \fIcurrent screen point \fR after it
                     21: displays the charcter \fIc\fR.
                     22: .PP
                     23: 
                     24: How characters are eventually
                     25: displayed on a user's terminal when using the UNIX putchar function
                     26: is affected by the UNIX host \fIstty\fR(1) settings
                     27: and the user's terminal characteristics.
                     28: Since \fIlputchar\fR displays directly onto the 630 MTG
                     29: screen, assumptions were made about desired \fIstty\fR
                     30: settings. In general, \fIlputchar\fR does as little processing on
                     31: the output stream as practical. 
                     32: If more extensive processing of control characters is needed, it can
                     33: be accomplished as shown in the example program below.
                     34: .P
                     35: The following are the only control characters processed by \fIlputchar\fR.
                     36: All other characters will be displayed as \fBASCII\fR characters:
                     37: .TP
                     38: .B \er
                     39: Carriage Return. Move the current point to the left edge of the window.
                     40: .TP
                     41: .B \en
                     42: Newline. Move the current point down one line and to the left edge of the 
                     43: window. Scroll the window if necessary.
                     44: .TP
                     45: .B \et
                     46: Horizontal tab. Tab characters are expanded to spaces with tab stops at every
                     47: eighth space.
                     48: .SH EXAMPLE
                     49: .LP
                     50: If an application program wanted to, for example, process bells and
                     51: backspaces rather than display the \fBASCII\fR bell and backspace
                     52: characters, it could define a function \fImylputchar\fR as follows:
                     53: .PP
                     54: .RS 3
                     55: .ft CM
                     56: .S -2
                     57: .nf
                     58: #include <dmd.h>
                     59: #include <font.h>
                     60: 
                     61: void lputchar();
                     62: void moveto();
                     63: void ringbell();
                     64: Point sPtCurrent();
                     65: 
                     66: mylputchar(c)
                     67: char c;
                     68: {
                     69:        Point curpos;
                     70: 
                     71:        switch( c ) {
                     72:        case '\e007':
                     73:                ringbell();
                     74:                break;
                     75:        case '\eb':
                     76:                /* get the current position
                     77:                ** if( not already at the left edge of the
                     78:                **      window ) {
                     79:                **      move back one character position
                     80:                **      lputchar a space to erase the last
                     81:                **      character and move back again
                     82:                ** }
                     83:                */
                     84:                curpos = sPtCurrent();
                     85:                if(curpos.x - FONTWIDTH(largefont)
                     86:                    >= Drect.origin.x) {
                     87:                        curpos.x -= FONTWIDTH(largefont);
                     88:                        moveto(curpos);
                     89:                        lputchar(' ');
                     90:                        moveto(curpos);
                     91:                }
                     92:                break;
                     93:        default:
                     94:                lputchar(c);
                     95:                break;
                     96:        }
                     97: }
                     98: .fi
                     99: .ft R
                    100: .RE
                    101: .S +2
                    102: .SH SEE ALSO
                    103: bputchar(3L), moveto(3L), printf(3L), structures(3R).
                    104: .br
                    105: stty(1) in the \fIUNIX System V User's Reference Manual\fR.
                    106: .br
                    107: putc(3S) in the \fIUNIX System V Programmer's Reference Manual\fR.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.