This function validates its parameter. If *newhandlermode* is anything other than 0 or 1, the function invokes the invalid parameter handler, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, **_****set_new_mode** returns -1 and sets **errno** to **EINVAL**.

This information applies to the interpretation of format strings in the `scanf` family of functions, including the secure versions such as `scanf_s`. These functions normally assume the input stream is divided into a sequence of tokens. Tokens are separated by whitespace (space, tab, or newline), or in the case of numerical types, by the natural end of a numerical data type as indicated by the first character that cannot be converted into numerical text. However, the width specification may be used to cause parsing of the input to stop before the natural end of a token.

The *width* specification consists of characters between the `%` and the type field specifier, which may include a positive integer called the *width* field and one or more characters indicating the size of the field, which may also be considered as modifiers of the type of the field, such as an indication of whether the integer type is **short** or **long**. Such characters are referred to as the size prefix.

*The width* field is a positive decimal integer controlling the maximum number of characters to be read for that field. No more than *width* characters are converted and stored at the corresponding `argument`. Fewer than *width* characters may be read if a whitespace character (space, tab, or newline) or a character that cannot be converted according to the given format occurs before *width* is reached.

The width specification is separate and distinct from the buffer size argument required by the secure versions of these functions (i.e., `scanf_s`, `wscanf_s`, etc.). In the following example, the width specification is 20, indicating that up to 20 characters are to be read from the input stream. The buffer length is 21, which includes room for the possible 20 characters plus the null terminator:

```

```

If the *width* field is not used, `scanf_s` will attempt to read the entire token into the string. If the size specified is not large enough to hold the entire token, nothing will be written to the destination string. If the *width* field is specified, then the first *width* characters in the token will be written to the destination string along with the null terminator.

The optional prefixes **h**, **l**, **ll**, **I64**, and **L** indicate the size of the `argument` (long or short, single-byte character or wide character, depending upon the type character that they modify). These format-specification characters are used with type characters in `scanf` or `wscanf` functions to specify interpretation of arguments as shown in the following table. The type prefix **I64** is a Microsoft extension and is not ANSI compatible. The type characters and their meanings are described in the "Type Characters for scanf functions" table in [scanf Type Field Characters](../c-runtime-library/scanf-type-field-characters.md).

|To specify|Use prefix|With type specifier|

|----------------|----------------|-------------------------|

|**double**|**l**|**e**, **E**, **f**, **g**, or **G**|

|**long double** (same as double)|**L**|**e**, **E**, **f**, **g**, or **G**|

|**long int**|**l**|**d**, **i**, **o**, **x**, or **X**|

|**long unsigned int**|**l**|**u**|

|**long long**|**ll**|**d**, **i**, **o**, **x**, or **X**|

|`short int`|**h**|**d**, **i**, **o**, **x**, or **X**|

|**short unsigned int**|**h**|**u**|

|__**int64**|**I64**|**d**, **i**, **o**, **u**, **x**, or **X**|

|Single-byte character with `scanf`|**h**|**c** or **C**|

|Single-byte character with `wscanf`|**h**|**c** or **C**|

|Wide character with `scanf`|**l**|**c** or **C**|

|Wide character with `wscanf`|**l**|**c**, or **C**|

|Single-byte - character string with `scanf`|**h**|**s** or **S**|

|Single-byte - character string with `wscanf`|**h**|**s** or **S**|

|Wide-character string with `scanf`|**l**|**s** or **S**|

|Wide-character string with `wscanf`|**l**|**s** or **S**|

The following examples use **h** and **l** with `scanf_s` functions and `wscanf_s` functions:

```

```

If using an unsecure function in the `scanf` family, omit the size parameter indicating the buffer length of the preceding argument.

To read strings not delimited by whitespace characters, a set of characters in brackets (**[ ]**) can be substituted for the **s** (string) type character. The set of characters in brackets is referred to as a control string. The corresponding input field is read up to the first character that does not appear in the control string. If the first character in the set is a caret (**^**), the effect is reversed: The input field is read up to the first character that does appear in the rest of the character set.

Note that **%[a-z]** and **%[z-a]** are interpreted as equivalent to **%[abcde...z]**. This is a common `scanf` function extension, but note that the ANSI standard does not require it.

To store a string without storing a terminating null character ('\0'), use the specification `%`*n***c** where *n* is a decimal integer. In this case, the **c** type character indicates that the argument is a pointer to a character array. The next *n* characters are read from the input stream into the specified location, and no null character ('\0') is appended. If *n* is not specified, its default value is 1.

The `scanf` function scans each input field, character by character. It may stop reading a particular input field before it reaches a space character for a variety of reasons:

- The specified width has been reached.

- The next character cannot be converted as specified.

- The next character conflicts with a character in the control string that it is supposed to match.

- The next character fails to appear in a given character set.

For whatever reason, when the `scanf` function stops reading an input field, the next input field is considered to begin at the first unread character. The conflicting character, if there is one, is considered unread and is the first character of the next input field or the first character in subsequent read operations on the input stream.

[scanf, _scanf_l, wscanf, _wscanf_l](../c-runtime-library/reference/scanf-scanf-l-wscanf-wscanf-l.md)

[scanf_s, _scanf_s_l, wscanf_s, _wscanf_s_l](../c-runtime-library/reference/scanf-s-scanf-s-l-wscanf-s-wscanf-s-l.md)

[Format Specification Fields: scanf and wscanf Functions](../c-runtime-library/format-specification-fields-scanf-and-wscanf-functions.md)

[scanf Type Field Characters](../c-runtime-library/scanf-type-field-characters.md)