Watcom C Library : getc, getch, getchar, getche, _getcliprgn, getcmd

 

 

Watcom C Library Reference : getc, getch, getchar, getche, _getcliprgn, getcmd

 

 

 

 

getc

 

Synopsis : #include <stdio.h> 

              int getc( FILE *fp );

 

Description : The getc function gets the next character from the file designated by fp. The character is returned as an int value. The getc function is equivalent to fgetc, except that it may be implemented as a macro.

 

 

Returns : The getc function returns the next character from the input stream pointed to by fp. If the stream is at end-of-file, the end-of-file indicator is set and getc returns EOF. If a read error occurs, the error indicator is set and getc returns EOF. When an error has oce errno contains a value indicating the type of error that has been detected.

 

 

See Also : fgetc, fgetchar, fgets, fopen, getchar, gets, ungetc

 

Example :

#include <stdio.h>

void main( )

{
    FILE     *fp;

    int       c;

 

    fp = fopen( "file", "r" );

    if( fp != NULL ) {

        while( (c = getc( fp )) != EOF )
            putchar( c );

        fclose( fp );

    }

}

 

Classification : ANSI
Systems : All

 

 

 

 

 

getch

 

Synopsis : #include <conio.h> 

              int getch( void );

 

Description : The getch function obtains the next available keystroke from the console. Nothing is echoed on the screen (the function getche will echo the keystroke, if possible). When no keystroke is available, the function waits until a key is depressed. The kbhit function can be used to determine if a keystroke is available.

 

 

Returns : A value of EOF is returned when an error is detected; otherwise the getch function returns the value of the keystroke (or character).

When the keystroke represents an extended function key (for example, a function key, a cursor-movement key or the ALT key with a letter or a digit), zero is returned and the next call to getch returns a value for the extended function.

 

 

See Also : getche, kbhit, putch, ungetch

Example :

#include <stdio.h> 

#include <conio.h>

void main( )

{
    int     c;

    printf( "Press any key\n" );

    c = getch( );

    printf( "You pressed %c (%d)\n", c, c);

}

 

Classification : WATCOM
Systems : All

 

 

 

 

 

getchar

 

Synopsis : #include <stdio.h> 

              int getchar( void );

 

Description : The getchar function is equivalent to getc with the argument stdin.

 

 

Returns : The getchar function returns the next character from the input stream pointed to by stdin. If the stream is at end-of-file, the end-of-file indicator is set and getchar returns EOF. If a read error occurs, the error indicator is set and getchar returns EOF. When an error has occurred, errno contains a value indicating the type of error that has been detected.

 

 

See Also : fgetc, fgetchar, getc

 

Example :

#include <stdio.h>

void main( )

{
    FILE     *fp;

    int       c;

 

    fp = freopen( "file", "r", stdin );

    while( (c = getchar( )) != EOF )
        putchar( c );

    fclose( fp );

}

 

Classification : ANSI
Systems : All

 

 

 

 

 

getche

 

Synopsis : #include <conio.h> 

              int getche( void );

 

Description : he getche function obtains the next available keystroke from the console. The function will wait until a keystroke is available. That character is echoed on the screen at the position of the cursor (use getch when it is not desired to echo the keystroke).
The kbhit function can be used to determine if a keystroke is available.

 

 

Returns : A value of EOF is returned when an error is detected; otherwise, the getche function returns the value of the keystroke (or character).

When the keystroke represents an extended function key (for example, a function key, a cursor-movement key or the ALT key with a letter or a digit), zero is returned and the next call to getche returns a value for the extended function.

 

 

See Also : getch, kbhit, putch, ungetch

 

Example :

#include <stdio.h> 

#include <conio.h>

void main( )

{
    int     c;

    printf( "Press any key\n" );

    c = getche( );

    printf( "You pressed %c (%d)\n", c, c);

}

 

Classification : WATCOM
Systems : All

 

 

 

 

 

_getcliprgn

 

Synopsis : #include <graph.h> 

              void _FAR _getcliprgn ( short _FAR *x1, short _FAR *y1,
                                        short _FAR *x2, short _FAR *y2 );


Description : The _getcliprgn function returns the location of the current clipping region. A clipping region is defined with the _setcliprgn or _setviewport functions. By default, the clipping region is the entire screen.

The current clipping region is a rectangular area of the screen to which graphics output is restricted. The top left corner of the clipping region is placed in the arguments (x1, y1). The bottom right corner of the clipping region is placed in (x2, y2).

 

 

Returns : The _getcliprgn function returns the location of the current clipping region.

 

 

See Also : _setcliprgn, _setviewport

 

Example :

#include <conio.h> 

#include <graph.h>

main( )

{
    short     x1, y1, x2, y2;

    _setvideomode ( _VRES16COLOR );

    _getcliprgn( &x1, &y1, &x2, &y2 );

    _setcliprgn ( 130, 100, 510, 380 );

    _ellipse( _GBORDER, 120, 90, 520, 390 );

    getch( );

 

    _setcliprgn( x1, y1, x2, y2);

    _setvideomode ( _DEFAULTMODE );

} 

 

Classification : PC Graphics
Systems : DOS, QNX

 

 

 

 

 

 

getcmd

 

Synopsis : #include <process.h> 

              char *getcmd( char *cmd_line );

 

Description : The getcmd function causes the command line information, with the program name removed, to be copied to cmd_line. The information is terminated with a '\0' character. This provides a method of obtaining the original parameters to a program unchanged (with the white space intact).

This information can also be obtained by examining the vector of program parameters passed to the main function in the program.

 

 

Returns : The address of the target cmd_line is returned.

 

 

See Also : abort, atexit, _bgetcmd, exec Functions, exit, _exit, getenv, main, onexit, putenv, spawn Functions, system

 

Example : 

Suppose a program were invoked with the command line 

    myprog arg-1 ( my  stuff ) here

 

where that program contains

 

#include <stdio.h> 

#include <process.h>

void main( )
{
    char     cmds[128];
    printf( "%s\n", getcmd( cmds ) );

}

 

produces the following :
arg-1 ( my  stuff ) here

 

Classification : WATCOM
Systems : All

 

 

 

 

 

 

 

 

This manual describes the WATCOM C library for DOS, Windows, and OS/2, It includes the Standard C Library (as defined in the ANSI C Standard).

 

WATCOM C Language Reference manual describes the ANSI C Programming language and extensions to it which are supported by WATCOM C/C++ (32bit)