Skip to content

Commit fa2cdbf

Browse files
author
Colin Robertson
authored
Bug fixes, migration additions (#160)
* Fix broken link to profiling tools * Fix issue in code sample. * Format fixes * Add draft of retargeting doc * Additions and formatting * Figure out why example isn't appearing * Add multi-targeting doc to TOC * Another attempt at example fix * Fix missing code attempt 3
1 parent 01111aa commit fa2cdbf

File tree

7 files changed

+141
-47
lines changed

7 files changed

+141
-47
lines changed

‎.vscode/settings.json‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"files.associations": {}
3+
}

‎docs/c-language/c-floating-point-constants.md‎

Lines changed: 13 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -43,30 +43,26 @@ A "floating-point constant" is a decimal number that represents a signed real nu
4343

4444
## Syntax
4545
*floating-point-constant*:
46-
*fractional-constant exponent-part* opt*floating-suffix* opt
47-
48-
*digit-sequence exponent-part floating-suffix* opt
46+
&nbsp;&nbsp; *fractional-constant exponent-part*<sub>opt</sub> *floating-suffix*<sub>opt</sub>
47+
&nbsp;&nbsp; *digit-sequence exponent-part floating-suffix*<sub>opt</sub>
4948

5049
*fractional-constant*:
51-
*digit-sequence* opt**.** *digit-sequence*
52-
53-
*digit-sequence* **.**
50+
&nbsp;&nbsp; *digit-sequence*<sub>opt</sub> **.** *digit-sequence*
51+
&nbsp;&nbsp; *digit-sequence* **.**
5452

5553
*exponent-part*:
56-
**e** *sign* opt*digit-sequence*
57-
58-
**E** *sign* opt*digit-sequence*
54+
&nbsp;&nbsp; **e** *sign*<sub>opt</sub> *digit-sequence*
55+
&nbsp;&nbsp; **E** *sign*<sub>opt</sub> *digit-sequence*
5956

6057
*sign* : one of
61-
**+ –**
58+
&nbsp;&nbsp; **+ –**
6259

6360
*digit-sequence*:
64-
*digit*
65-
66-
*digit-sequence digit*
61+
&nbsp;&nbsp; *digit*
62+
&nbsp;&nbsp; *digit-sequence digit*
6763

6864
*floating-suffix* : one of
69-
**f l F L**
65+
&nbsp;&nbsp; **f l F L**
7066

7167
You can omit either the digits before the decimal point (the integer portion of the value) or the digits after the decimal point (the fractional portion), but not both. You can leave out the decimal point only if you include an exponent. No white-space characters can separate the digits or characters of the constant.
7268

@@ -80,16 +76,16 @@ A "floating-point constant" is a decimal number that represents a signed real nu
8076
25E-4 /* = 0.0025 */
8177
```
8278

83-
Floating-point constants are positive unless they are preceded by a minus sign (**–**). In this case, the minus sign is treated as a unary arithmetic negation operator. Floating-point constants have type **float**, **double**, or `long double`.
79+
Floating-point constants are positive unless they are preceded by a minus sign (**–**). In this case, the minus sign is treated as a unary arithmetic negation operator. Floating-point constants have type `float`, `double`, or `long double`.
8480

85-
A floating-point constant without an **f**, **F**, **l**, or **L** suffix has type **double**. If the letter **f** or **F** is the suffix, the constant has type **float**. If suffixed by the letter **l** or **L**, it has type `long double`. For example:
81+
A floating-point constant without an **f**, **F**, **l**, or **L** suffix has type `double`. If the letter **f** or **F** is the suffix, the constant has type `float`. If suffixed by the letter **l** or **L**, it has type `long double`. For example:
8682

8783
```
8884
100L /* Has type long double */
8985
100F /* Has type float */
9086
```
9187

92-
Note that the Microsoft C compiler maps **long double** to type **double**. See [Storage of Basic Types](../c-language/storage-of-basic-types.md) for information about type **double**, **float**, and **long**.
88+
Note that the Microsoft C compiler internally represents `long double` the same as type `double`. See [Storage of Basic Types](../c-language/storage-of-basic-types.md) for information about type `double`, `float`, and `long double`.
9389

9490
You can omit the integer portion of the floating-point constant, as shown in the following examples. The number .75 can be expressed in many ways, including the following:
9591

‎docs/c-language/limits-on-floating-point-constants.md‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -47,19 +47,19 @@ translation.priority.ht:
4747

4848
|Constant|Meaning|Value|
4949
|--------------|-------------|-----------|
50-
|**FLT_DIGDBL_DIGLDBL_DIG**|Number of digits, *q*, such that a floating-point number with *q* decimal digits can be rounded into a floating-point representation and back without loss of precision.|6 15 15|
51-
|**FLT_EPSILONDBL_EPSILONLDBL_EPSILON**|Smallest positive number *x*, such that *x* + 1.0 is not equal to 1.0|1.192092896e–07F 2.2204460492503131e–016 2.2204460492503131e–016|
50+
|**FLT_DIG**<br />**DBL_DIG**<br />**LDBL_DIG**|Number of digits, *q*, such that a floating-point number with *q* decimal digits can be rounded into a floating-point representation and back without loss of precision.|6<br />15<br />15|
51+
|**FLT_EPSILON**<br />**DBL_EPSILON**<br />**LDBL_EPSILON**|Smallest positive number *x*, such that *x* + 1.0 is not equal to 1.0|1.192092896e–07F<br />2.2204460492503131e–016<br />2.2204460492503131e–016|
5252
|**FLT_GUARD**||0|
53-
|**FLT_MANT_DIGDBL_MANT_DIGLDBL_MANT_DIG**|Number of digits in the radix specified by **FLT_RADIX** in the floating-point significand. The radix is 2; hence these values specify bits.|24 53 53|
54-
|**FLT_MAXDBL_MAXLDBL_MAX**|Maximum representable floating-point number.|3.402823466e+38F 1.7976931348623158e+308 1.7976931348623158e+308|
55-
|**FLT_MAX_10_EXPDBL_MAX_10_EXPLDBL_MAX_10_EXP**|Maximum integer such that 10 raised to that number is a representable floating-point number.|38 308 308|
56-
|**FLT_MAX_EXPDBL_MAX_EXPLDBL_MAX_EXP**|Maximum integer such that **FLT_RADIX** raised to that number is a representable floating-point number.|128 1024 1024|
57-
|**FLT_MINDBL_MINLDBL_MIN**|Minimum positive value.|1.175494351e–38F 2.2250738585072014e–308 2.2250738585072014e–308|
58-
|**FLT_MIN_10_EXPDBL_MIN_10_EXPLDBL_MIN_10_EXP**|Minimum negative integer such that 10 raised to that number is a representable floating-point number.|–37<br /><br /> –307<br /><br /> –307|
59-
|**FLT_MIN_EXPDBL_MIN_EXPLDBL_MIN_EXP**|Minimum negative integer such that **FLT_RADIX** raised to that number is a representable floating-point number.|–125<br /><br /> –1021<br /><br /> –1021|
53+
|**FLT_MANT_DIG**<br />**DBL_MANT_DIG**<br />**LDBL_MANT_DIG**|Number of digits in the radix specified by **FLT_RADIX** in the floating-point significand. The radix is 2; hence these values specify bits.|24<br />53<br />53|
54+
|**FLT_MAX**<br />**DBL_MAX**<br />**LDBL_MAX**|Maximum representable floating-point number.|3.402823466e+38F<br />1.7976931348623158e+308<br />1.7976931348623158e+308|
55+
|**FLT_MAX_10_EXP**<br />**DBL_MAX_10_EXP**<br />**LDBL_MAX_10_EXP**|Maximum integer such that 10 raised to that number is a representable floating-point number.|38<br />308<br />308|
56+
|**FLT_MAX_EXP**<br />**DBL_MAX_EXP**<br />**LDBL_MAX_EXP**|Maximum integer such that **FLT_RADIX** raised to that number is a representable floating-point number.|128<br />1024<br />1024|
57+
|**FLT_MIN**<br />**DBL_MIN**<br />**LDBL_MIN**|Minimum positive value.|1.175494351e–38F<br />2.2250738585072014e–308<br />2.2250738585072014e–308|
58+
|**FLT_MIN_10_EXP**<br />**DBL_MIN_10_EXP**<br />**LDBL_MIN_10_EXP**|Minimum negative integer such that 10 raised to that number is a representable floating-point number.|–37<br />–307<br />–307|
59+
|**FLT_MIN_EXP**<br />**DBL_MIN_EXP**<br />**LDBL_MIN_EXP**|Minimum negative integer such that **FLT_RADIX** raised to that number is a representable floating-point number.|–125<br />–1021<br />–1021|
6060
|**FLT_NORMALIZE**||0|
61-
|**FLT_RADIX_DBL_RADIX_LDBL_RADIX**|Radix of exponent representation.|2 2 2|
62-
|**FLT_ROUNDS_DBL_ROUNDS_LDBL_ROUNDS**|Rounding mode for floating-point addition.|1 (near) 1 (near) 1 (near)|
61+
|**FLT_RADIX**<br />**_DBL_RADIX**<br />**_LDBL_RADIX**|Radix of exponent representation.|2<br />2<br />2|
62+
|**FLT_ROUNDS**<br />**_DBL_ROUNDS**<br />**_LDBL_ROUNDS**|Rounding mode for floating-point addition.|1 (near)<br />1 (near)<br />1 (near)|
6363

6464
Note that the information in the above table may differ in future implementations.
6565

‎docs/c-runtime-library/reference/configthreadlocale.md‎

Lines changed: 15 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,6 @@ f1_keywords:
2828
- "configthreadlocale"
2929
dev_langs:
3030
- "C++"
31-
- "C"
3231
helpviewer_keywords:
3332
- "configthreadlocale function"
3433
- "locales, per-thread"
@@ -66,7 +65,7 @@ int _configthreadlocale(
6665
);
6766
```
6867

69-
#### Parameters
68+
### Parameters
7069
`type`
7170
The option to set. One of the options listed in the following table.
7271

@@ -85,9 +84,7 @@ int _configthreadlocale(
8584
`0`
8685
Retrieves the current setting for this particular thread.
8786

88-
These functions affect the behavior of `setlocale`, `_tsetlocale`, `_wsetlocale`, `_beginthread`, and `_beginthreadex`. If another method is used to create threads, the locale settings have no effect on those threads.
89-
90-
When per-thread locale is disabled, any subsequent call to `setlocale` or `_wsetlocale` changes the locale of all threads. When per-thread locale is enabled, `setlocale` or `_wsetlocale` only affects the current thread's locale.
87+
These functions affect the behavior of `setlocale`, `_tsetlocale`, and `_wsetlocale`. When per-thread locale is disabled, any subsequent call to `setlocale` or `_wsetlocale` changes the locale of all threads that use the global locale. When per-thread locale is enabled, `setlocale` or `_wsetlocale` only affects the current thread's locale.
9188

9289
If you use `_configurethreadlocale` to enable a per-thread locale, we recommend that you call `setlocale` or `_wsetlocale` to set the preferred locale in that thread immediately afterward.
9390

@@ -101,15 +98,16 @@ int _configthreadlocale(
10198

10299
## Example
103100

104-
```
105-
106-
// crt_configthreadlocale.cpp
101+
```C++
102+
// crt_configthreadlocale.cpp
107103
//
108104
// This program demonstrates the use of _configthreadlocale when
109-
// using is two independent threads.
105+
// using two independent threads.
110106
//
107+
// Compile by using: cl /EHsc /W4 crt_configthreadlocale.cpp
111108

112109
#include <locale.h>
110+
#include <mbctype.h>
113111
#include <process.h>
114112
#include <windows.h>
115113
#include <stdio.h>
@@ -142,12 +140,14 @@ int get_time(unsigned char* str)
142140

143141
// This thread sets its locale to German
144142
// and prints the time.
145-
unsigned __stdcall SecondThreadFunc( void* pArguments )
143+
unsigned __stdcall SecondThreadFunc( void* /*pArguments*/ )
146144
{
147145
unsigned char str[BUFF_SIZE];
148146

147+
_configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
148+
149149
// Set the thread code page
150-
_setmbcp(_MB_CP_ANSI)
150+
_setmbcp(_MB_CP_ANSI);
151151

152152
// Set the thread locale
153153
printf("The thread locale is now set to %s.\n",
@@ -171,8 +171,8 @@ int main()
171171
unsigned threadID;
172172
unsigned char str[BUFF_SIZE];
173173

174-
// Configure per-thread locale to cause all subsequently created
175-
// threads to have their own locale.
174+
// Enable per-thread locale causes all subsequent locale
175+
// setting changes in this thread to only affect this thread.
176176
_configthreadlocale(_ENABLE_PER_THREAD_LOCALE);
177177

178178
// Retrieve the time string from the helper function
@@ -194,7 +194,7 @@ int main()
194194

195195
// Destroy the thread object.
196196
CloseHandle( hThread );
197-
}
197+
}
198198
```
199199
200200
```Output
@@ -205,11 +205,8 @@ The thread locale is now set to German_Germany.1252.
205205
The time in German locale is: 'Mittwoch, 12. Mai 2004'
206206
```
207207

208-
## .NET Framework Equivalent
209-
Not applicable. However, see [Using the CurrentCulture Property](http://msdn.microsoft.com/en-us/3156042d-6082-4205-90b4-c917ae6a3ba6).
210-
211208
## See Also
212209
[setlocale, _wsetlocale](../../c-runtime-library/reference/setlocale-wsetlocale.md)
213210
[_beginthread, _beginthreadex](../../c-runtime-library/reference/beginthread-beginthreadex.md)
214211
[Locale](../../c-runtime-library/locale.md)
215-
[Multithreading and Locales](../../parallel/multithreading-and-locales.md)
212+
[Multithreading and Locales](../../parallel/multithreading-and-locales.md)

‎docs/index.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -293,7 +293,7 @@ description: Learn how to use C++ to develop applications, services, and tools f
293293
</a>
294294
</li>
295295
<li>
296-
<a href="https://github.com/visualstudio/profiler/profiling-tools">
296+
<a href="https://github.com/visualstudio/profiling/profiling-tools">
297297
<div class="cardSize">
298298
<div class="cardPadding">
299299
<div class="card">

‎docs/porting/TOC.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@
77
### [Porting Guide: COM Spy](porting-guide-com-spy.md)
88
### [Porting Guide: Spy++](porting-guide-spy-increment.md)
99
## [Upgrading Projects from Earlier Versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)
10+
## [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md)
1011
### [Overview of potential upgrade issues (Visual C++)](overview-of-potential-upgrade-issues-visual-cpp.md)
1112
### [Upgrade your code to the Universal CRT](upgrade-your-code-to-the-universal-crt.md)
1213
### [Modifying WINVER and _WIN32_WINNT](modifying-winver-and-win32-winnt.md)

0 commit comments

Comments
 (0)