Keil Logo


#include <stdio.h>

char *gets (
  char *string,        /* string to read */
  unsigned int len);   /* max characters to read */

The gets function calls the getchar function to read a line of characters into string. The line consists of all characters up to and including the first newline character ('\n'). The newline character is replaced by a null character ('\0') in string.

The len argument specifies the maximum number of characters that may be read. If len characters are read before a newline is encountered, the gets function terminates string with a null character and returns.


  • This function is implementation-specific and is based on the operation of the _getkey and putchar functions. These functions, as provided in the standard library, read and write characters using the microcontroller's serial port. Custom functions may use other I/O devices.
Return Value

The gets function returns string.

See Also


#include <stdio.h>

void tst_gets (void) {
  char buf [21];

  do {
    gets (buf, sizeof(buf)-1);
    printf ("Input string \"%s\"", buf);
  } while (buf [0] != '\0');
  Arm logo
Important information

This site uses cookies to store information on your computer. By continuing to use our site, you consent to our cookies.

Change Settings

Privacy Policy Update

Arm’s Privacy Policy has been updated. By continuing to use our site, you consent to Arm’s Privacy Policy. Please review our Privacy Policy to learn more about our collection, use and transfers
of your data.