13

I am trying to read a number character by character, but I don't know if the stdin buffer is empty or not.

My first solution was to look for '\n' character in the stdin buffer, but this isn't any good if I want to enter multiple numbers separated by spaces.

How can I know if I have characters in the stdin buffer or not?

I need to do it in C and need it to be portable.

3
  • 1
    Check for EOF. (It's not actually a character, but it will be the value returned if the stream is empty.) Commented Nov 15, 2014 at 17:51
  • 1
    Do not check if stdin is empty. Read a character, check the status of the operation. If status is not "OK" assume stdin is empty ... if ((c = getchar()) == EOF) /*assume stdin empty; in reality could be some other reason*/; Commented Feb 9, 2021 at 17:43
  • Just to add to the previous comment, if getchar/getc/getc returns EOF, you don't have to assume stdin is empty, you can use feof to make sure. I think this is the most portable solution, and should work even if stdin has been redirected. Commented Jan 6, 2024 at 14:30

5 Answers 5

11

For plain descriptors, there are several solutions:

poll or select with timeout of 0. These would return immediately and result is either -1 with errno EAGAIN if no data is available or the number of descriptors with data (one, since you're checking only standard input).

ioctl is a Swiss Army knife of using descriptors. You need the request I_NREAD:

if (ioctl(0, I_NREAD, &n) == 0 && n > 0)
    // We have exactly n bytes to read

However, the correct solution is to read everything you got (using scanf) as a line, and then process the result. And this works good enough with sscanf:

char buf[80]; // Large enough
scanf("%79s", buf); // Read everything we have in standard input
if (sscanf(buf, "%d", &number) == 1)
    // We have a number

... as long as you properly handle rereading strings that are longer than your buffer, and other real-life complications. This solution also works with actual FILE * streams, while poll/select/ioctl can only handle file descriptors.

Sign up to request clarification or add additional context in comments.

9 Comments

if I'm trying something like this while(!feof(stdin)) { c = getchar(); putchar(c); } whill enter an infinite loop
functions poll / select / ioctl won't work eather because I nead a new library that is not included in a standard IDE (Code::Blocks that I use in college) so the solution remain the third one reading it with a buff and checking if the buf lenght is 80 (in this case) then I have to keep reading
If your stdin is read from console, it will be at EOF only if you send EOF-character which is ctrl+d as far as I know. poll, select, ioctl are all POSIX functions and ... it would be off-topic to discuss if it should be on any system. sscanf solution on other hand should work as is.
feof does not test whether the input is empty, but whether an end-of-input condition has occurred on a prior input operation. feof shouldn't be called until an input operation has been tried and has indicated failure.
Right. I've removed the part about feof since for STDIN it will only return true if STDIN is closed and you've read everything from it and tried again.
|
4

Here is an easy select solution to check stdin emptiness:

fd_set readfds;
FD_ZERO(&readfds);
FD_SET(STDIN_FILENO, &readfds);
fd_set savefds = readfds;

struct timeval timeout;
timeout.tv_sec = 0;
timeout.tv_usec = 0;

int chr;

int sel_rv = select(1, &readfds, NULL, NULL, &timeout);
if (sel_rv > 0) {
  puts("Input:");
  while ((chr = getchar()) != EOF) putchar(chr);
} else if (sel_rv == -1) {
  perror("select failed");
}

readfds = savefds;

It needs unistd.h, stdlib.h and stdio.h.

An explanation can be found here.

Actually, select returns:

  • the number of ready descriptors that are contained in the descriptor sets
  • 0 if the time limit expires
  • -1 if an error occurred (errno would be set)

6 Comments

works on linux but not on windows (it needs to be portable)
windows < Linux
@Tandura on any POSIX compatible system. Usually on Windows you have to use specific methods that won't work on other systems. So I think any *nix is better than just Windows. But yes, it's not completely portable. Idk how to do it on Windows, maybe you know?
Remember select returns -1 when in error (which is also a true value)
If the point of checking via select() is to avoid hanging, the posted code will hang if there is more input sent than stdin can buffer in one underlying read() call on STDIN_FILENO. Also, the posted code does not detect if there is already unread data available to be read buffered in the stdin buffer.
select doesn't check stdin. stdin is a FILE * object which implements a buffered stream. That stream can contain unread input which is invisible to select and poll. If you blindly call select, you could end up blocking for input, even though it has already been read and is sitting in the stdin object.
1

I was inspired from this as referenced by @stek29's post on this page and prepared a simple example as follows:

#include <stdio.h>
#include <stdlib.h>
#include <unistd.h>

int main(void)
{
    fd_set readfds;
    FD_ZERO(&readfds);

    struct timeval timeout;
    timeout.tv_sec = 0;
    timeout.tv_usec = 0;

    char message[50];

    while(1)
    {
        FD_SET(STDIN_FILENO, &readfds);

        if (select(1, &readfds, NULL, NULL, &timeout))
        {
            scanf("%s", message);
            printf("Message: %s\n", message);
        }

        printf("...\n");
        sleep(1);
    }

    return(0);
}

4 Comments

works for me! i replaced sleep with usleep(10); and removed the printf("...\n");
Mixing select() on STDIN_FILENO and using FILE-based operations like scanf() on stdin is likely to cause problems. If, for example, scanf() reads and buffers a full 5 kb of input from STDIN_FILENO, but only copies a 30-byte line (to message in this example), there will still be almost 5,000 bytes in the stdin buffer that the sample program above will never see because there's nothing left at the file descriptor level. Don't do this.
Please don't use sleep; set timeout.tv_sec to 1 and timeout.tv_usec to 0 before calling select. This will still wait for one sec per loop when there's no input, but process your input immediately when there is any.
0

There are many ways to check if standard input has input available. The most portable ones are, in that order: select, fcntl and poll.

Here are some snippets on how to do it, case by case.

#include <stdio.h>     /* Same old */
#include <stdlib.h>    /* Same old */
#include <time.h>      /* struct timeval for select() */
#include <unistd.h>    /* select() */
#include <poll.h>      /* poll() */
#include <sys/ioctl.h> /* FIONREAD ioctl() */
#include <termios.h>   /* tcgetattr() and tcsetattr() */
#include <fcntl.h>     /* fnctl() */

#define BUFF 256

int chkin_select(void);
int chkin_poll(void);
int chkin_ioctl(void);
int chkin_fcntl(void);
int chkin_termios(void);

/*
  Simple loops to test various options of
  nonblocking test for standard input
*/

int main(void)
{
    char sin[BUFF] = "r";

    printf("\nType 'q' to advance\nTesting select()\n");
    while(sin[0]++ != 'q')
    {
        while(!chkin_select())
        {
            printf("nothing to read on select()\n");
            sleep(2);
        }
        fgets(sin, BUFF, stdin);
        printf("\nInput select(): %s\n", sin);
    }

    printf("\nType 'q' to advance\nTesting poll()\n");
    while(sin[0]++ != 'q')
    {
        while(!chkin_poll())
        {
            printf("nothing to read poll()\n");
            sleep(2);
        }
        fgets(sin, BUFF, stdin);
        printf("\nInput poll(): %s\n", sin);
    }

    printf("\nType 'q' to advance\nTesting ioctl()\n");
    while(sin[0]++ != 'q')
    {
        while(!chkin_ioctl())
        {
            printf("nothing to read ioctl()\n");
            sleep(2);
        }
        fgets(sin, BUFF, stdin);
        printf("\nInput ioctl(): %s\n", sin);
    }

    printf("\nType 'q' to advance\nTesting fcntl()\n");
    while(sin[0]++ != 'q')
    {
        while(!chkin_fcntl())
        {
            printf("nothing to read fcntl()\n");
            sleep(2);
        }
        fgets(sin, BUFF, stdin);
        printf("\nInput fcntl: %s\n", sin);
    }

    printf("\nType 'q' to advance\nTesting termios()\n");
    while(sin[0]++ != 'q')
    {
        while(!chkin_termios())
        {
            printf("nothing to read termios()\n");
            sleep(2);
        }
        fgets(sin, BUFF, stdin);
        printf("\nInput termios: %s\n", sin);
    }

    return EXIT_SUCCESS;
}

/*
   select() and pselect() allow a program to monitor
   multiple file descriptors, waiting until one or
   more of the file descriptors become "ready" for
   some class of I/O operation (e.g., input possible).
   A file descriptor is considered ready if it is
   possible to perform a corresponding I/O operation
   (e.g., read(2) without blocking, or a
   sufficiently small write(2)).
 */
int chkin_select(void)
{
    fd_set rd;
    struct timeval tv = {0};
    int ret;

    FD_ZERO(&rd);
    FD_SET(STDIN_FILENO, &rd);
    ret = select(1, &rd, NULL, NULL, &tv);

    return (ret>0);
}

/*  poll() performs a similar task to select(2): it
    waits for one of a set of file descriptors to
    become ready to perform I/O.

       The set of file descriptors to be monitored
       is specified in the fds argument, which is
       an array of structures of the following form:

           struct pollfd {
               int   fd;         // File descriptor //
               short events;     // Requested events //
               short revents;    // Returned events //
           };

       The caller should specify the number of
       items in the fds array in nfds.
*/
int chkin_poll(void)
{
    int ret;
    struct pollfd pfd[1] = {0};

    pfd[0].fd = STDIN_FILENO;
    pfd[0].events = POLLIN;
    ret = poll(pfd, 1, 0);

    return (ret>0);
}

/*
    The ioctl(2) call for terminals and serial ports
    accepts many possible command arguments. Most
    require a third argument, of varying type,
    here called argp or arg.

       Use of ioctl makes for nonportable
       programs.  Use the POSIX interface
       described in termios(3) whenever
       possible.
*/
int chkin_ioctl(void)
{
    int n;
    ioctl(STDIN_FILENO, FIONREAD, &n);
    return (n>0);
}

/*
    fcntl() performs one of the operations described
    below on the open file descriptor fd. The
    operation is determined by cmd.

    fcntl() can take an optional third argument.
    Whether or not this argument is required is
    determined by cmd.  The required argument
    type is indicated in parentheses after each
    cmd name (in most cases, the required type
    is int, and we identify the argument using
    the name arg), or void is specified if the
    argument is not required.

    Certain of the operations below are supported
    only since a particular Linux kernel version.
    The preferred method of checking whether the
    host kernel supports a particular operation
    is to invoke fcntl() with the desired cmd
    value and then test whether the call
    failed with EINVAL, indicating that
    the kernel does not recognize this
    value.
*/
int chkin_fcntl(void)
{
    int flag, ch;

    flag = fcntl(STDIN_FILENO, F_GETFL, 0); /* Save old flags */
    fcntl(STDIN_FILENO, F_SETFL, flag|O_NONBLOCK); /* Set non-block */
    ch = ungetc(getc(stdin), stdin);
    fcntl(STDIN_FILENO, F_SETFL, flag); /* Return old state */

    return (ch != EOF);
}

/*
 The termios functions describe a general terminal
 interface that is provided to control
 asynchronous communications ports.
 This function doesn't wait for '\n' to return!
 */
int chkin_termios(void)
{
    struct termios old, new;
    int ch;

    tcgetattr(STDIN_FILENO, &old); /* Save settings */

    new = old;
    new.c_lflag &= ~ICANON;  /* Non-canonical mode: inputs
                                by char, not lines */
    new.c_cc[VMIN] = 0;      /* Wait for no bytes at all */
    new.c_cc[VTIME] = 0;     /* timeout */
    tcsetattr(STDIN_FILENO, TCSANOW, &new); /* New settings */

    ch = ungetc(getc(stdin), stdin); /* Check by reading and
                                        puking it back */

    tcsetattr(STDIN_FILENO, TCSANOW, &old); /* Restore old settings */
    return (ch != EOF);
}

Try to avoid ioctl and termios; they are too specific, or too low-level. Also, you can't really use feof in a meaningful way with stdin or any FIFO for that matter. You can guarantee the pointer position, and if you try ftell or fseek you will get an error (ask perror).


References (Linux manual pages):

5 Comments

Mixing select() on the file descriptor and reading using stdin via calls such as fgets() won't work to avoid blocking. Data can get read into a buffered stdin and remain there, leaving unread data that will never be detected by select() on the underlying file descriptor. Disabling buffering on stdin won't work either because then a call such as fgets() can block - and the only reason to check for input is to prevent such blocking.
Hi Andrew. Thanks for the input. Two things: fgets() is not the kernel of those snippets. New programmers have trouble even trying to call those functions. I could add that this problem will happen not only with select(). It is a fair warning to those using the examples. If you happen to know your data format, you can check and read them all (with fgets(), scanf(), getc(), write() or other). But if you have unformatted data coming in, you better check char by char. The examples I gave above will assume data ends with \n (except termios() that goes a char at time).
Second: tests I've made to fill stdin with redirection or file writing did work well using select(). On the other hand, ioctl() hangs if you fill stdin using redirection. Also, it is important to notice in those examples that termios() have a very different approach and the behavior is to indicate immediately as soon as a char is in the buffer. Those examples should be tamed by the programmer, they are not supposed to be a "solution to all your problems". Most important: know your data input, or be prepared for errors.
The logic will not work properly even with with a TTY device in character-at-a-time input mode if the user pastes a block of text into the terminal. The stdin stream will end up buffering multiple characters. sevbuf(stdin, NULL); fixes this on a glibc-based Linux system. I seem to recall that ISO C doesn't define buffering as having an effect on input streams though.
POSIX does say that buffering is for input and output. But it doesn't spell out that an unbuffered input stream will issue one byte reads; it just says that the bytes "appear from the source as soon as possible". That does not rule out reading multiple bytes that are already available; in fact the one-byte-read is specifically delaying the passage of already-available input in the TTY into the buffer.
-1

Use:

int number = -1;  // -1 is default standard for error;
int success = 0;  // Will serve as boolean (0 == FALSE; 1 == TRUE)
char buf[BUFFER_SIZE];  // Define this as convenient (e.g.,
                        // #define BUFFER_SIZE 100)
char *p = buf;   // We'll use a pointer in order to preserve
                 // input, in case you want to use it later

fgets(buf, BUFFER_SIZE, stdin);  // Use fgets() for security AND
                                 // to grab EVERYTHING from stdin,
                                 // including whitespaces

while(*p != '\0') {  // Parse the buffer
    if(sscanf(p, "%d", &number) == 1) {  // At each char position, try
                                         // to grab a valid number format.
        success = 1;                     // If you succeed, then flag it.
        break;
    }

    p++; // If you don't succeed, advance the
         // pointer to the next char position
 }  // Repeat the cycle until the end of
    // buf (string end char == '\0')

if (success)

    // You get the position by calculating the diff
    // between the current position of the p and the
    // beginning position of the buf
    printf(">> Number=%d at position number %d.", number, (int)(p-buf));

else {
    // Do whatever you want in case of
    // failure at grabbing a number
}

1 Comment

Is this a bogus answer? And/or the result of plagiarism? How does it answer the question? - stdin emptiness. Why does it have "At each char position, try to grab a valid number format"? Is it just some random code from the Internet dumped here?

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Start asking to get answers

Find the answer to your question by asking.

Ask question

Explore related questions

See similar questions with these tags.