You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8fd49f8
Browse filesBrowse the repository at this point in the historyBrowse files
@@ -14,11 +14,11 @@ The Active Template Library (ATL) wizards generate boilerplate code for various
14
14
|-----------|-----------------|
15
15
|[Creating an ATL Project](../../atl/reference/creating-an-atl-project.md)|Describes the ATL project wizard and its settings.|
16
16
|[ATL Simple Object](../../atl/reference/adding-an-atl-simple-object.md)|Creates a basic object.|
17
-
|[ATL Property Page](../../atl/reference/adding-an-atl-property-page.md)|Creates a basic property page.|
18
-
|[ATL OLE DB Provider](../../atl/reference/adding-an-atl-ole-db-provider.md)|Creates a basic OLE DB provider.|
19
-
|[ATL OLE DB Consumer](../../atl/reference/adding-an-atl-ole-db-consumer.md)|Creates a basic OLE DB consumer.|
17
+
|[ATL Property Page](../../atl/reference/adding-an-atl-property-page.md)|Creates a basic property page.</br>Not available in Visual Studio 2019 and later.|
18
+
|[ATL OLE DB Provider](../../atl/reference/adding-an-atl-ole-db-provider.md)|Creates a basic OLE DB provider.</br>Not available in Visual Studio 2019 and later.|
19
+
|[ATL OLE DB Consumer](../../atl/reference/adding-an-atl-ole-db-consumer.md)|Creates a basic OLE DB consumer.</br>Not available in Visual Studio 2019 and later.|
20
20
|[ATL Dialog Box](../../atl/reference/adding-an-atl-dialog-box.md)|Creates a basic dialog box.|
21
21
|[ATL Control](../../atl/reference/adding-an-atl-control.md)|Creates a basic ActiveX control.|
22
-
|[ATL COM+ 1.0 Component](../../atl/reference/adding-an-atl-com-plus-1-0-component.md)|Creates a basic ATL COM+ 1.0 component|
23
-
|[ATL Active Server Page Component](../../atl/reference/adding-an-atl-active-server-page-component.md)|Creates a basic ATL Active Server Page component.|
22
+
|[ATL COM+ 1.0 Component](../../atl/reference/adding-an-atl-com-plus-1-0-component.md)|Creates a basic ATL COM+ 1.0 component.</br>Not available in Visual Studio 2019 and later.|
23
+
|[ATL Active Server Page Component](../../atl/reference/adding-an-atl-active-server-page-component.md)|Creates a basic ATL Active Server Page component.</br>Not available in Visual Studio 2019 and later.|
24
24
|[ATL COM Desktop Components](../../atl/atl-com-desktop-components.md)|Links to the ATL documentation.|
Copy file name to clipboardExpand all lines: docs/c-runtime-library/reference/strtod-strtod-l-wcstod-wcstod-l.md
+11-7Lines changed: 11 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,13 +49,17 @@ The locale to use.
49
49
50
50
## Return Value
51
51
52
-
**strtod** returns the value of the floating-point number, except when the representation would cause an overflow, in which case the function returns +/-**HUGE_VAL**. The sign of **HUGE_VAL** matches the sign of the value that cannot be represented. **strtod** returns 0 if no conversion can be performed or an underflow occurs.
52
+
**strtod** returns the value of the floating-point number, except when the representation would cause an overflow, in which case the function returns +/-**HUGE_VAL**. The sign of **HUGE_VAL** matches the sign of the value that cannot be represented. **strtod** returns `0` if no conversion can be performed or an underflow occurs.
53
53
54
-
**wcstod** returns values analogously to **strtod**. For both functions, **errno** is set to **ERANGE** if overflow or underflow occurs and the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). See [_doserrno, errno, _sys_errlist, and _sys_nerr](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md) for more information on this and other return codes.
54
+
**wcstod** returns values analogously to **strtod**:
55
+
- For both functions, **errno** is set to **ERANGE** if overflow or underflow occurs.
56
+
- If there are invalid parameters, **errno** is set to **EINVAL** and the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md).
57
+
58
+
For more information on this and other return codes, see [_doserrno, errno, _sys_errlist, and _sys_nerr](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md).
55
59
56
60
## Remarks
57
61
58
-
Each function converts the input string *strSource* to a **double**. The **strtod** function converts *strSource* to a double-precision value. **strtod** stops reading the string *strSource* at the first character it cannot recognize as part of a number. This may be the terminating null character. **wcstod** is a wide-character version of **strtod**; its *strSource* argument is a wide-character string. These functions behave identically otherwise.
62
+
Each function converts the input string *strSource* to a **double**. The **strtod** function converts *strSource* to a double-precision value. **strtod** stops reading the string *strSource* at the first character it cannot recognize as part of a number. This character may be the terminating null character. **wcstod** is a wide-character version of **strtod**; its *strSource* argument is a wide-character string. These functions behave identically otherwise.
59
63
60
64
By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
61
65
@@ -66,9 +70,9 @@ By default, this function's global state is scoped to the application. To change
The **LC_NUMERIC** category setting of the current locale determines recognition of the radix point character in *strSource*. For more information, see [setlocale](setlocale-wsetlocale.md). The functions without the **_l** suffix use the current locale; **_strtod_l** is identical to **_strtod_l** except that they use the *locale* passed in instead. For more information, see [Locale](../../c-runtime-library/locale.md).
73
+
The **LC_NUMERIC** category setting of the current locale determines recognition of the radix point character in *strSource*. For more information, see [setlocale](setlocale-wsetlocale.md). The functions without the **_l** suffix use the current locale; **_strtod_l** is identical to **_strtod_l** except they use the *locale* passed in instead. For more information, see [Locale](../../c-runtime-library/locale.md).
70
74
71
-
If *endptr*is not**NULL**, a pointer to the character that stopped the scan is stored at the location pointed to by *endptr*. If no conversion can be performed (no valid digits were found or an invalid base was specified), the value of *strSource* is stored at the location pointed to by *endptr*.
75
+
If *endptr*isn't**NULL**, a pointer to the character that stopped the scan is stored at the location pointed to by *endptr*. If no conversion can be performed (no valid digits were found or an invalid base was specified), the value of *strSource* is stored at the location pointed to by *endptr*.
72
76
73
77
**strtod** expects *strSource* to point to a string of one of the following forms:
74
78
@@ -77,9 +81,9 @@ If *endptr* is not **NULL**, a pointer to the character that stopped the scan is
The optional leading *whitespace* may consist of space and tab characters, which are ignored; *sign* is either plus (+) or minus (-); *digits* are one or more decimal digits; *hexdigits* are one or more hexadecimal digits; *radix* is the radix point character, either a period (.) in the default "C" locale, or the locale-specific value if the current locale is different or when *locale* is specified; a *sequence* is a sequence of alphanumeric or underscore characters. In both decimal and hexadecimal number forms, if no digits appear before the radix point character, at least one must appear after the radix point character. In the decimal form, the decimal digits can be followed by an exponent, which consists of an introductory letter (**e** or **E**) and an optionally signed integer. In the hexadecimal form, the hexadecimal digits can be followed by an exponent, which consists of an introductory letter (**p** or **P**) and an optionally signed hexadecimal integer that represents the exponent as a power of 2. In either form, if neither an exponent part nor a radix point character appears, a radix point character is assumed to follow the last digit in the string. Case is ignored in both the **INF** and **NAN** forms. The first character that does not fit one of these forms stops the scan.
84
+
The optional leading *whitespace* may consist of space and tab characters, which are ignored; *sign* is either plus (+) or minus (-); *digits* are one or more decimal digits; *hexdigits* are one or more hexadecimal digits; *radix* is the radix point character, either a period (.) in the default "C" locale, or the locale-specific value if the current locale is different or when *locale* is specified; a *sequence* is a sequence of alphanumeric or underscore characters. In both decimal and hexadecimal number forms, if no digits appear before the radix point character, at least one must appear after the radix point character. In the decimal form, the decimal digits can be followed by an exponent, which consists of an introductory letter (**e** or **E**) and an optionally signed integer. In the hexadecimal form, the hexadecimal digits can be followed by an exponent, which consists of an introductory letter (**p** or **P**) and an optionally signed hexadecimal integer that represents the exponent as a power of 2. In either form, if there isn't an exponent part or a radix point character, a radix point character is assumed to follow the last digit in the string. Case is ignored in both the **INF** and **NAN** forms. The first character that doesn't fit one of these forms stops the scan.
81
85
82
-
The UCRT versions of these functions do not support conversion of Fortran-style (**d** or **D**) exponent letters. This non-standard extension was supported by earlier versions of the CRT, and may be a breaking change for your code. The UCRT versions support hexadecimal strings and round-tripping of INF and NAN values, which were not supported in earlier versions. This can also cause breaking changes in your code. For example, the string "0x1a" would be interpreted by **strtod** as 0.0 in previous versions, but as 26.0 in the UCRT version.
86
+
The UCRT versions of these functions don't support conversion of Fortran-style (**d** or **D**) exponent letters. This non-standard extension was supported by earlier versions of the CRT, and may be a breaking change for your code. The UCRT versions support hexadecimal strings and round-tripping of INF and NAN values, which weren't supported in earlier versions. This can also cause breaking changes in your code. For example, the string "0x1a" would be interpreted by **strtod** as 0.0 in previous versions, but as 26.0 in the UCRT version.
Points to memory used to store the internal state of the parser so that the parser can continue from where it left off the next time you call **wcstok**.
69
+
62
70
## Return Value
63
71
64
72
Returns a pointer to the next token found in *strToken*. The functions return **NULL** when no more tokens are found. Each call modifies *strToken* by substituting a null character for the first delimiter that occurs after the returned token.
@@ -67,6 +75,8 @@ Returns a pointer to the next token found in *strToken*. The functions return **
67
75
68
76
The **strtok** function finds the next token in *strToken*. The set of characters in *strDelimit* specifies possible delimiters of the token to be found in *strToken* on the current call. **wcstok** and **_mbstok** are wide-character and multibyte-character versions of **strtok**. The arguments and return value of **wcstok** are wide-character strings; those of **_mbstok** are multibyte-character strings. These three functions behave identically otherwise.
69
77
78
+
The two argument version of **wcstok** is not standard. If you need to use that version, you'll need to define `_CRT_NON_CONFORMING_WCSTOK` before you `#include <wchar.h>` (or `#include <string.h>`).
79
+
70
80
> [!IMPORTANT]
71
81
> These functions incur a potential threat brought about by a buffer overrun problem. Buffer overrun problems are a frequent method of system attack, resulting in an unwarranted elevation of privilege. For more information, see [Avoiding Buffer Overruns](/windows/win32/SecBP/avoiding-buffer-overruns).
72
82
@@ -94,6 +104,7 @@ By default, this function's global state is scoped to the application. To change
94
104
|-------------|---------------------|
95
105
|**strtok**|\<string.h>|
96
106
|**wcstok**|\<string.h> or \<wchar.h>|
107
+
|**_wcstok_l**|<tchar.h>|
97
108
|**_mbstok**, **_mbstok_l**|\<mbstring.h>|
98
109
99
110
For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
0 commit comments