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

Technical Support

On-Line Manuals

Cx51 User's Guide

Cx51 Introduction Compiling Programs Language Extensions Preprocessor Advanced Programming 8051 Derivatives Error Messages Library Reference Library Files Source Code Standard Types jmp_buf size_t va_list wchar_t Macros CBYTE CWORD DBYTE DWORD FARRAY FCARRAY FCVAR FVAR PBYTE PWORD XBYTE XWORD 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 80c517.h absacc.h assert.h ctype.h float.h intrins.h limits.h math.h rtx51tny.h setjmp.h stdarg.h stddef.h stdio.h stdlib.h string.h Reference _chkfloat_ _crol_ _cror_ _getkey _irol_ _iror_ _lrol_ _lror_ _nop_ _pop_ _push_ _testbit_ _tolower _toupper abs acos acos517 asin asin517 assert atan atan2 atan517 atof atof517 atoi atol cabs calloc ceil cos cos517 cosh exp exp517 fabs floor fmod free getchar gets init_mempool isalnum isalpha iscntrl isdigit isgraph islower isprint ispunct isspace isupper isxdigit labs log log10 log10517 log517 longjmp malloc memccpy memchr memcmp memcpy memmove memset modf offsetof pow printf printf517 putchar puts rand realloc scanf scanf517 setjmp sin sin517 sinh sprintf sprintf517 sqrt sqrt517 srand sscanf sscanf517 strcat strchr strcmp strcpy strcspn strlen strncat strncmp strncpy strpbrk strpos strrchr strrpbrk strrpos strspn strstr strtod strtod517 strtok strtol strtoul switchbank tan tan517 tanh toascii toint tolower toupper ungetchar va_arg va_end va_start vprintf vsprintf Appendix

sscanf

Summary
#include <stdio.h>

int sscanf (
  char *buffer,           /* scanf input buffer */
  const char *fmtstr      /* format string */
  〚, arguments...〛);    /* additional arguments */
Description

The sscanf function reads data from the string buffer. Data input are stored in the locations specified by argument according to the format string fmtstr. Each argument must be a pointer to a variable that corresponds to the type defined in fmtstr. The type specified in fmtstr controls the interpretation of the input data. The fmtstr may be composed of one or more whitespace characters, non-whitespace characters, and format specifications, as defined in the scanf function description.

Note

  • The total number of bytes that may be passed to this function is limited due to the memory restrictions imposed by the 8051. A maximum of 15 bytes may be passed in SMALL or COMPACT model. A maximum of 40 bytes may be passed in LARGE model.
Return Value

The sscanf function returns the number of input fields that were successfully converted. An EOF is returned if an error is encountered.

See Also

gets, puts, sprintf, vprintf, vsprintf

Example
#include <stdio.h>

void tst_sscanf (void) {
  char a;
  int b;
  long c;

  unsigned char x;
  unsigned int y;
  unsigned long z;

  float f,g;

  char d, buf [10];

  int argsread;

  printf ("Reading a signed byte, int,and long\n");
  argsread = sscanf ("1 -234 567890",
                     "%bd %d %ld",
                     &a, &b, &c);
  printf ("%d arguments read\n", argsread);

  printf ("Reading an unsigned byte, int, and long\n");
  argsread = sscanf ("2 44 98765432",
                     "%bu %u %lu",
                     &x, &y, &z);
  printf ("%d arguments read\n", argsread);

  printf ("Reading a character and a string\n");
  argsread = sscanf ("a abcdefg",
                     "%c %9s",
                     &d, buf);
  printf ("%d arguments read\n", argsread);

  printf ("Reading two floating-point numbers\n");
  argsread = sscanf ("12.5 25.0",
                     "%f %f",
                     &f, &g);
  printf ("%d arguments read\n", argsread);
}
Contact Site Map Press PrivacyCopyright © 2012 ARM Ltd and ARM Germany GmbH. All rights reserved.