Skip to content

Commit 2869fbf

Browse files
authored
Merge pull request #4615 from corob-msft/bulk-fix-crt-acrolinx-16
Bulk fix CRT acrolinx issues 16 of N
2 parents 9ea9b72 + c5c1427 commit 2869fbf

File tree

100 files changed

+228
-228
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

100 files changed

+228
-228
lines changed

docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ The second value to compare.
5555
5656
## Return value
5757
58-
If successful, returns the larger of *`x`* or *`y`*. The value returned is exact, and does not depend on any form of rounding.
58+
If successful, returns the larger of *`x`* or *`y`*. The value returned is exact, and doesn't depend on any form of rounding.
5959
6060
Otherwise, may return one of the following values:
6161
@@ -65,7 +65,7 @@ Otherwise, may return one of the following values:
6565
|*`y`* = NaN|*`x`*|
6666
|*`x`* and *`y`* = NaN|NaN|
6767
68-
This function does not use the errors specified in [`_matherr`](matherr.md).
68+
This function doesn't use the errors specified in [`_matherr`](matherr.md).
6969
7070
## Remarks
7171

docs/c-runtime-library/reference/fmin-fminf-fminl.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ If successful, returns the smaller of *`x`* or *`y`*.
6363
|*`y`* is NaN|*`x`*|
6464
|*`x`* and *`y`* are NaN|NaN|
6565
66-
The function does not cause [`_matherr`](matherr.md) to be invoked, cause any floating-point exceptions, or change the value of `errno`.
66+
The function doesn't cause [`_matherr`](matherr.md) to be invoked, cause any floating-point exceptions, or change the value of `errno`.
6767
6868
## Remarks
6969

docs/c-runtime-library/reference/fopen-s-wfopen-s.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -61,7 +61,7 @@ The **`fopen_s`** function opens the file that's specified by *`filename`*. **`_
6161

6262
These functions validate their parameters. If *`pFile`*, *`filename`*, or *`mode`* is a null pointer, these functions generate an invalid parameter exception, as described in [Parameter validation](../parameter-validation.md).
6363

64-
Always check the return value to see if the function succeeded before you do any further operations on the file. If an error occurs, the error code is returned and the global variable `errno` is set. For more information, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
64+
Always check the return value to see if the function succeeded before you do any further operations on the file. If an error occurs, the error code is returned, and the global variable `errno` is set. For more information, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
6565

6666
By default, this function's global state is scoped to the application. To change it, see [Global state in the CRT](../global-state.md).
6767

docs/c-runtime-library/reference/fopen-wfopen.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ The **`fopen`** function opens the file that is specified by *`filename`*. By de
4747

4848
**`fopen`** accepts paths that are valid on the file system at the point of execution; **`fopen`** accepts UNC paths and paths that involve mapped network drives as long as the system that executes the code has access to the share or mapped drive at the time of execution. When you construct paths for **`fopen`**, make sure that drives, paths, or network shares will be available in the execution environment. You can use either forward slashes (`/`) or backslashes (`\`) as the directory separators in a path.
4949

50-
Always check the return value to see whether the pointer is NULL before you perform any other operations on the file. If an error occurs, the global variable `errno` is set and may be used to obtain specific error information. For more information, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
50+
Always check the return value to see whether the pointer is NULL before you perform any other operations on the file. If an error occurs, the global variable `errno` is set, and may be used to obtain specific error information. For more information, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
5151

5252
By default, this function's global state is scoped to the application. To change it, see [Global state in the CRT](../global-state.md).
5353

docs/c-runtime-library/reference/fpclass-fpclassf.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ The **`_fpclass`** and **`_fpclassf`** functions return an integer value that in
4949

5050
## Remarks
5151

52-
The **`_fpclass`** and **`_fpclassf`** functions are Microsoft-specific. They are similar to [`fpclassify`](fpclassify.md), but return more detailed information about the argument. The **`_fpclassf`** function is only available when compiled for the x64 platform.
52+
The **`_fpclass`** and **`_fpclassf`** functions are Microsoft-specific. They're similar to [`fpclassify`](fpclassify.md), but return more detailed information about the argument. The **`_fpclassf`** function is only available when compiled for the x64 platform.
5353

5454
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
5555

docs/c-runtime-library/reference/fpieee-flt.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -49,10 +49,10 @@ The `_FPIEEE_RECORD` structure, defined in Fpieee.h, contains information pertai
4949
|----------------------------|-----------------|
5050
|`RoundingMode`<br/>`Precision`|These **`unsigned int`** fields contain information about the floating-point environment at the time the exception occurred.|
5151
|`Operation`|This **`unsigned int`** field indicates the type of operation that caused the trap. If the type is a comparison (`_FpCodeCompare`), you can supply one of the special `_FPIEEE_COMPARE_RESULT` values (as defined in Fpieee.h) in the **Result.Value** field. The conversion type (`_FpCodeConvert`) indicates that the trap occurred during a floating-point conversion operation. You can look at the `Operand1` and `Result` types to determine the type of conversion being attempted.|
52-
|`Operand1`<br/>`Operand2`<br/>`Result`|These `_FPIEEE_VALUE` structures indicate the types and values of the proposed result and operands. Each structure contains these fields:<br /><br /> `OperandValid` - Flag indicating whether the responding value is valid.<br />`Format` - Data type of the corresponding value. The format type might be returned even if the corresponding value is not valid.<br />`Value` - Result or operand data value.|
53-
|`Cause`<br/>`Enable`<br/>`Status`|`_FPIEEE_EXCEPTION_FLAGS` contains one bit field per type of floating point exception. There is a correspondence between these fields and the arguments used to mask the exceptions supplied to [`_controlfp`](control87-controlfp-control87-2.md). The exact meaning of each bit depends on context:<br /><br /> `Cause` - Each set bit indicates the particular exception that was raised.<br />`Enable` - Each set bit indicates that the particular exception is currently unmasked.<br />`Status` - Each set bit indicates that the particular exception is currently pending. This includes exceptions that have not been raised because they were masked by `_controlfp`.|
52+
|`Operand1`<br/>`Operand2`<br/>`Result`|These `_FPIEEE_VALUE` structures indicate the types and values of the proposed result and operands. Each structure contains these fields:<br /><br /> `OperandValid` - Flag indicating whether the responding value is valid.<br />`Format` - Data type of the corresponding value. The format type might be returned even if the corresponding value isn't valid.<br />`Value` - Result or operand data value.|
53+
|`Cause`<br/>`Enable`<br/>`Status`|`_FPIEEE_EXCEPTION_FLAGS` contains a bit field for each type of floating point exception. There's a correspondence between these fields and the arguments used to mask the exceptions supplied to [`_controlfp`](control87-controlfp-control87-2.md). The exact meaning of each bit depends on context:<br /><br /> `Cause` - Each set bit indicates the particular exception that was raised.<br />`Enable` - Each set bit indicates that the particular exception is currently unmasked.<br />`Status` - Each set bit indicates that the particular exception is currently pending, which includes exceptions that haven't been raised because they were masked by `_controlfp`.|
5454

55-
Pending exceptions that are disabled are raised when you enable them. This can result in undefined behavior when using **`_fpieee_flt`** as an exception filter. Always call [`_clearfp`](clear87-clearfp.md) before enabling floating point exceptions.
55+
Pending exceptions that are disabled are raised when you enable them. These exceptions can result in undefined behavior when using **`_fpieee_flt`** as an exception filter. Always call [`_clearfp`](clear87-clearfp.md) before enabling floating point exceptions.
5656

5757
## Requirements
5858

docs/c-runtime-library/reference/fpreset.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ void _fpreset( void );
2222
2323
## Remarks
2424
25-
The **`_fpreset`** function reinitializes the floating-point math package. **`_fpreset`** is usually used with `signal`, `system`, or the `_exec` or `_spawn` functions. If a program traps floating-point error signals (`SIGFPE`) with `signal`, it can safely recover from floating-point errors by invoking **`_fpreset`** and using `longjmp`.
25+
The **`_fpreset`** function reinitializes the floating-point math package. **`_fpreset`** is often used with `signal`, `system`, or the `_exec` or `_spawn` functions. If a program traps floating-point error signals (`SIGFPE`) with `signal`, it can safely recover from floating-point errors by invoking **`_fpreset`** and using `longjmp`.
2626
2727
This function is deprecated when compiling with [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) because the common language runtime only supports the default floating-point precision.
2828

docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ The locale to use.
6060

6161
## Remarks
6262

63-
**`_fprintf_p`** formats and prints a series of characters and values to the output *`stream`*. Each function *`argument`* (if any) is converted and output according to the corresponding format specification in *`format`*. For **`_fprintf_p`**, the *`format`* argument has the same syntax and use that it has in `_printf_p`. These functions support positional parameters, meaning that the order of the parameters used by the format string can be changed. For more information about positional parameters, see [printf_p Positional Parameters](../printf-p-positional-parameters.md).
63+
**`_fprintf_p`** formats and prints a series of characters and values to the output *`stream`*. Each function *`argument`* (if any) is converted and output according to the corresponding format specification in *`format`*. For **`_fprintf_p`**, the *`format`* argument has the same syntax that it has in `_printf_p`. These functions support positional parameters, meaning that the order of the parameters used by the format string can be changed. For more information about positional parameters, see [printf_p Positional Parameters](../printf-p-positional-parameters.md).
6464

6565
**`_fwprintf_p`** is a wide-character version of **`_fprintf_p`**; in **`_fwprintf_p`**, *`format`* is a wide-character string. These functions behave identically if the stream is opened in ANSI mode. **`_fprintf_p`** doesn't currently support output into a UNICODE stream.
6666

docs/c-runtime-library/reference/fputc-nolock-fputwc-nolock.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,9 +41,9 @@ Each of these functions returns the character written. For error information, se
4141

4242
## Remarks
4343

44-
**`_fputc_nolock`** and **`_fputwc_nolock`** are identical to `fputc` and `fputwc`, respectively, except that they are not protected from interference by other threads. They might be faster because they do not incur the overhead of locking out other threads. Use these functions only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
44+
**`_fputc_nolock`** and **`_fputwc_nolock`** are identical to `fputc` and `fputwc`, respectively, except that they aren't protected from interference by other threads. They might be faster because they don't incur the overhead of locking out other threads. Use these functions only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
4545

46-
The two functions behave identically if the stream is opened in ANSI mode. **`_fputc_nolock`** does not currently support output into a UNICODE stream.
46+
The two functions behave identically if the stream is opened in ANSI mode. **`_fputc_nolock`** doesn't currently support output into a UNICODE stream.
4747

4848
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
4949

@@ -60,7 +60,7 @@ By default, this function's global state is scoped to the application. To change
6060
|**`_fputc_nolock`**|\<stdio.h>|
6161
|**`_fputwc_nolock`**|\<stdio.h> or \<wchar.h>|
6262

63-
The console is not supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console—`stdin`, `stdout`, and `stderr`—must be redirected before C run-time functions can use them in UWP apps. For more compatibility information, see [Compatibility](../compatibility.md).
63+
The console isn't supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console—`stdin`, `stdout`, and `stderr`—must be redirected before C run-time functions can use them in UWP apps. For more compatibility information, see [Compatibility](../compatibility.md).
6464

6565
## Example
6666

docs/c-runtime-library/reference/fputchar-fputwchar.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,13 +32,13 @@ Character to be written.
3232

3333
## Return value
3434

35-
Each of these functions returns the character written. For **`_fputchar`**, a return value of `EOF` indicates an error. For **`_fputwchar`**, a return value of `WEOF` indicates an error. If c is `NULL`, these functions generate an invalid parameter exception, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, they return `EOF` (or `WEOF`) and set `errno` to `EINVAL`.
35+
Each of these functions returns the character written. For **`_fputchar`**, a return value of `EOF` indicates an error. For **`_fputwchar`**, a return value of `WEOF` indicates an error. If c is `NULL`, these functions generate an invalid parameter exception, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, **`_fputchar`** returns `EOF` (**`_fputwchar`** returns `WEOF`), and they set `errno` to `EINVAL`.
3636

3737
For more information about these and other error codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
3838

3939
## Remarks
4040

41-
Both of these functions writes the single character *`c`* to `stdout` and advances the indicator as appropriate. **`_fputchar`** is equivalent to `fputc( stdout )`. It is also equivalent to `putchar`, but implemented only as a function, rather than as a function and a macro. Unlike `fputc` and `putchar`, these functions are not compatible with the ANSI standard.
41+
Both of these functions write the single character argument *`c`* to `stdout` and advance the indicator as appropriate. **`_fputchar`** is equivalent to `fputc( stdout )`. It's also equivalent to `putchar`, but implemented only as a function, rather than as a function and a macro. Unlike `fputc` and `putchar`, these functions aren't compatible with the ANSI standard.
4242

4343
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
4444

@@ -55,7 +55,7 @@ By default, this function's global state is scoped to the application. To change
5555
|**`_fputchar`**|\<stdio.h>|
5656
|**`_fputwchar`**|\<stdio.h> or \<wchar.h>|
5757

58-
The console is not supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console—`stdin`, `stdout`, and `stderr`—must be redirected before C run-time functions can use them in UWP apps. For more compatibility information, see [Compatibility](../compatibility.md).
58+
The console isn't supported in Universal Windows Platform (UWP) apps. The standard stream handles that are associated with the console—`stdin`, `stdout`, and `stderr`—must be redirected before C run-time functions can use them in UWP apps. For more compatibility information, see [Compatibility](../compatibility.md).
5959

6060
## Example
6161

docs/c-runtime-library/reference/fputs-fputws.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,13 +36,13 @@ Pointer to `FILE` structure.
3636

3737
## Return value
3838

39-
Each of these functions returns a nonnegative value if it is successful. On an error, **`fputs`** and **`fputws`** return `EOF`. If *`str`* or *`stream`* is a null pointer, these functions invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, these functions set `errno` to `EINVAL` and then return `EOF`.
39+
Each of these functions returns a nonnegative value if it's successful. On an error, **`fputs`** and **`fputws`** return `EOF`. If *`str`* or *`stream`* is a null pointer, these functions invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, these functions set `errno` to `EINVAL` and then return `EOF`.
4040

4141
For more information on error codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
4242

4343
## Remarks
4444

45-
Each of these functions copies *`str`* to the output *`stream`* at the current position. **`fputws`** copies the wide-character argument *`str`* to *`stream`* as a multibyte-character string or a wide-character string according to whether *`stream`* is opened in text mode or binary mode, respectively. Neither function copies the terminating null character.
45+
Each of these functions copies *`str`* to the output *`stream`* at the current position. **`fputws`** copies the wide-character argument *`str`* to *`stream`* as a multibyte-character string or a wide-character string when *`stream`* is opened in text mode or binary mode, respectively. Neither function copies the terminating null character.
4646

4747
The two functions behave identically if the stream is opened in ANSI mode. **`fputs`** doesn't currently support output into a UNICODE stream.
4848

docs/c-runtime-library/reference/fread-nolock-s2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ See [`fread_s`](fread-s.md).
4848

4949
## Remarks
5050

51-
This function is a non-locking version of `fread_s`. It is identical to `fread_s` except that it is not protected from interference by other threads. It might be faster because it does not incur the overhead of locking out other threads. Use this function only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
51+
This function is a non-locking version of `fread_s`. It's identical to `fread_s` except that it isn't protected from interference by other threads. It might be faster because it doesn't incur the overhead of locking out other threads. Use this function only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
5252

5353
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
5454

docs/c-runtime-library/reference/fread-nolock.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ See [`fread`](fread.md).
4545

4646
## Remarks
4747

48-
This function is a non-locking version of `fread`. It is identical to `fread` except that it is not protected from interference by other threads. It might be faster because it does not incur the overhead of locking out other threads. Use this function only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
48+
This function is a non-locking version of `fread`. It's identical to `fread` except that it isn't protected from interference by other threads. It might be faster because it doesn't incur the overhead of locking out other threads. Use this function only in thread-safe contexts such as single-threaded applications or where the calling scope already handles thread isolation.
4949

5050
By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
5151

0 commit comments

Comments
 (0)