C251 User's Guide
Home Products Download Events Support
Search Keil.com for:

Technical Support

On-Line Manuals

C251 User's Guide

C251 Introduction Compiling Programs Language Extensions Preprocessor Advanced Programming Error Messages Library Reference Library Files Source Code Standard Types jmp_buf va_list Macros CBYTE CVAR CARRAY DARRAY DBYTE DVAR HARRAY HBYTE HVAR NARRAY NBYTE NVAR XARRAY XBYTE XVAR Routines by Category Buffer Manipulation Routines Character Routines Data Conversion Routines Intrinsic Routines Math Routines Memory Allocation Routines Stream I/O Routines String Routines Variable Length Argument Routines Miscellaneous Routines Include Files SFR Definitions absacc.h assert.h ctype.h float.h intrins.h limits.h math.h setjmp.h stdarg.h stddef.h stdio.h stdlib.h string.h Reference _chkdouble_ _chkfloat_ _crol_ _cror_ _getkey _irol_ _iror_ _lrol_ _lror_ _nop_ _testbit_ _tolower _toupper abs acos asin assert atan atan2 atof atoi atol cabs calloc ceil cos cosh exp fabs fcalloc ffree finit_mempool floor fmalloc fmemcpy fmemset frealloc free getchar gets hmemccpy hmemchr hmemcmp hmemcpy hmemmove hmemset hstrcmp hstrcpy hstrlen hstrncpy init_mempool isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs log log10 longjmp malloc memccpy memchr memcmp memcpy memmove memset modf offsetof pow printf putchar puts rand realloc scanf setjmp sin sinh sprintf sqrt srand sscanf strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strpos strrchr strrpbrk strrpos strspn tan tanh toascii toint tolower toupper ungetchar va_arg va_end va_start vprintf vsprintf xcalloc xfree xinit_mempool xmalloc xmemcpy xmemset xrealloc Appendix

gets

Summary
#include <stdio.h>

char *gets (
  char *string,   /* string to read */
  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');
}
Contact Site Map Press PrivacyCopyright © 2012 ARM Ltd and ARM Germany GmbH. All rights reserved.