Keil Logo Arm Logo

CARM User's Guide

Discontinued

gets

Summary
#include <stdio.h>

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

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.

Note

  • 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

puts

Example
#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');
}

Keil logo

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.