Skip to content

Commit 90c300b

Browse files
authored
Merge pull request MicrosoftDocs#3435 from MicrosoftDocs/master
3/09/2021 AM Publish
2 parents 6ed44d9 + 8e9f6c3 commit 90c300b

24 files changed

+68
-70
lines changed

docs/c-runtime-library/c-run-time-library-reference.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ Provides links to the C runtime library functions, organized by function family.
3737
[Language and country/region strings](locale-names-languages-and-country-region-strings.md)\
3838
Describes how to use the `setlocale` function to set the language and Country/Region strings.
3939

40-
[C runtime (CRT) and C++ Standard Library `.lib` files](crt-library-features.md)\
41-
Discusses the `.lib` files that make up the C runtime libraries and their associated compiler options and preprocessor directives.
40+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](crt-library-features.md)\
41+
List of `.lib` files that make up the C runtime libraries and their associated compiler options and preprocessor directives.
4242

4343
## Related Sections
4444

docs/c-runtime-library/compatibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,4 +35,4 @@ Except as noted within the documentation for specific functions, the UCRT is com
3535
|[UNIX](../c-runtime-library/unix.md)|Provides guidelines for porting programs to UNIX.|
3636
|[Windows Platforms (CRT)](../c-runtime-library/windows-platforms-crt.md)|Lists the operating systems that are the CRT supports.|
3737
|[Backward Compatibility](../c-runtime-library/backward-compatibility.md)|Describes how to map old CRT names to the new ones.|
38-
|[CRT Library Features](../c-runtime-library/crt-library-features.md)|Provides an overview of the CRT library (.lib) files and the associated compiler options.|
38+
|[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)|Provides an overview of the CRT library (.lib) files and the associated compiler options.|

docs/c-runtime-library/crt-initialization.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,4 +90,4 @@ So, the CRT library uses both `__xc_a` and `__xc_z` to determine the start and e
9090

9191
## See also
9292

93-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
93+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/crt-library-features.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ms.date: "3/5/2021"
55
ms.topic: "reference"
66
helpviewer_keywords: ["MSVCR71.dll", "libraries [C++], multithreaded", "library files, run-time", "LIBCMT.lib", "LIBCP.lib", "LIBCPMT.lib", "run-time libraries, C", "CRT, release versions", "MSVCP71.dll", "LIBC.lib", "libraries [C++]", "libraries [C++], run-time", "linking [C++], libraries"]
77
---
8-
# C runtime (CRT) and C++ Standard Library `.lib` files
8+
# C runtime (CRT) and C++ Standard Library (STL) `.lib` files
99

1010
This topic lists the Microsoft C runtime library `.lib` files that you can link against when you develop your application, and their associated compiler options and preprocessor directives.
1111

docs/c-runtime-library/direction-flag.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,4 +16,4 @@ The C Run-Time library functions, such as the string-manipulation and buffer-man
1616

1717
## See also
1818

19-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
19+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/link-options.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,4 +32,4 @@ CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and
3232

3333
## See also
3434

35-
- [CRT Library Features](../c-runtime-library/crt-library-features.md)
35+
- [C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/multithreaded-libraries-performance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,4 +28,4 @@ The performance of the multithreaded libraries has been improved and is close to
2828

2929
## See also
3030

31-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
31+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/parameter-validation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,4 +25,4 @@ For more information on `errno`, see [errno, _doserrno, _sys_errlist, and _sys_n
2525
## See also
2626

2727
[Security Features in the CRT](../c-runtime-library/security-features-in-the-crt.md)\
28-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
28+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -123,4 +123,4 @@ New MYLIB variable is: c:\mylib;c:\yourlib
123123

124124
## See also
125125

126-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
126+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)

docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,4 +38,4 @@ If you need to choose between a function and a macro implementation of a library
3838
## See also
3939

4040
[Type-generic math](tgmath.md)\
41-
[CRT Library Features](../c-runtime-library/crt-library-features.md)
41+
[C runtime (CRT) and C++ Standard Library (STL) `.lib` files](../c-runtime-library/crt-library-features.md)
Lines changed: 19 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,15 @@
11
---
2-
description: "Learn more about: _CrtMemDifference"
32
title: "_CrtMemDifference"
4-
ms.date: "11/04/2016"
3+
description: "Learn more about: _CrtMemDifference"
4+
ms.date: "3/8/2021"
55
api_name: ["_CrtMemDifference"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_CrtMemDifference", "CrtMemDifference"]
1010
helpviewer_keywords: ["CrtMemDifference function", "_CrtMemDifference function"]
11-
ms.assetid: 0f327278-b551-482f-958b-76941f796ba4
1211
---
13-
# _CrtMemDifference
12+
# `_CrtMemDifference`
1413

1514
Compares two memory states and returns their differences (debug version only).
1615

@@ -26,42 +25,42 @@ int _CrtMemDifference(
2625

2726
### Parameters
2827

29-
*stateDiff*<br/>
30-
Pointer to a **_CrtMemState** structure that is used to store the differences between the two memory states (returned).
28+
*`stateDiff`*\
29+
Pointer to a **`_CrtMemState`** structure that is used to store the differences between the two memory states (returned).
3130

32-
*oldState*<br/>
33-
Pointer to an earlier memory state (**_CrtMemState** structure).
31+
*`oldState`*\
32+
Pointer to an earlier memory state (**`_CrtMemState`** structure).
3433

35-
*newState*<br/>
36-
Pointer to a later memory state (**_CrtMemState** structure).
34+
*`newState`*\
35+
Pointer to a later memory state (**`_CrtMemState`** structure).
3736

3837
## Return Value
3938

40-
If the memory states are significantly different, **_CrtMemDifference** returns TRUE. Otherwise, the function returns FALSE.
39+
If the memory states are significantly different, **`_CrtMemDifference`** returns `TRUE`. Otherwise, the function returns FALSE.
4140

4241
## Remarks
4342

44-
The **_CrtMemDifference** function compares *oldState* and *newState* and stores their differences in *stateDiff*, which can then be used by the application to detect memory leaks and other memory problems. When [_DEBUG](../../c-runtime-library/debug.md) is not defined, calls to **_CrtMemDifference** are removed during preprocessing.
43+
The **`_CrtMemDifference`** function compares *`oldState`* and *`newState`* and stores their differences in *`stateDiff`*, which can then be used by the app to detect memory leaks and other memory problems. When [_DEBUG](../../c-runtime-library/debug.md) isn't defined, calls to **`_CrtMemDifference`** are removed during preprocessing.
4544

46-
*newState* and *oldState* must each be a valid pointer to a **_CrtMemState** structure, defined in Crtdbg.h, that has been filled in by [_CrtMemCheckpoint](crtmemcheckpoint.md) before calling **_CrtMemDifference**. *stateDiff* must be a pointer to a previously allocated instance of the **_CrtMemState** structure. If *stateDiff*, *newState*, or *oldState* is **NULL**, the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, [errno, _doserrno, _sys_errlist, and _sys_nerr](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md) is set to **EINVAL** and the function returns FALSE.
45+
*`newState`* and *`oldState`* must each be a valid pointer to a **`_CrtMemState`** structure, defined in Crtdbg.h, that has been filled in by [`_CrtMemCheckpoint`](crtmemcheckpoint.md) before calling **`_CrtMemDifference`**. *`stateDiff`* must be a pointer to a previously allocated instance of the **`_CrtMemState`** structure. If *`stateDiff`*, *`newState`*, or *`oldState`* is **`NULL`**, the invalid parameter handler is invoked, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, [`errno, _doserrno, _sys_errlist, and _sys_nerr`](../../c-runtime-library/errno-doserrno-sys-errlist-and-sys-nerr.md) is set to **`EINVAL`** and the function returns FALSE.
4746

48-
**_CrtMemDifference** compares the **_CrtMemState** field values of the blocks in *oldState* to those in *newState* and stores the result in *stateDiff*. When the number of allocated block types or total number of allocated blocks for each type differs between the two memory states, the states are said to be significantly different. The difference between the largest amount ever allocated at once for the two states and the difference between total allocations for the two states are also stored in *stateDiff*.
47+
**`_CrtMemDifference`** compares the **`_CrtMemState`** field values of the blocks in *`oldState`* to those in *`newState`* and stores the result in *`stateDiff`*. When the number of allocated block types or total number of allocated blocks for each type differs between the two memory states, the states are said to be significantly different. The difference between the largest amount ever allocated at once for the two states and the difference between total allocations for the two states are also stored in *`stateDiff`*.
4948

50-
By default, internal C run-time blocks (**_CRT_BLOCK**) are not included in memory state operations. The [_CrtSetDbgFlag](crtsetdbgflag.md) function can be used to turn on the **_CRTDBG_CHECK_CRT_DF** bit of **_crtDbgFlag** to include these blocks in leak detection and other memory state operations. Freed memory blocks (**_FREE_BLOCK**) do not cause **_CrtMemDifference** to return TRUE.
49+
By default, internal C run-time blocks (**`_CRT_BLOCK`**) aren't included in memory state operations. The [_CrtSetDbgFlag](crtsetdbgflag.md) function can be used to turn on the **`_CRTDBG_CHECK_CRT_DF`** bit of **`_crtDbgFlag`** to include these blocks in leak detection and other memory state operations. Freed memory blocks (**`_FREE_BLOCK`**) don't cause **`_CrtMemDifference`** to return `TRUE`.
5150

52-
For more information about heap state functions and the **_CrtMemState** structure, see [Heap State Reporting Functions](/visualstudio/debugger/crt-debug-heap-details). For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see [CRT Debug Heap Details](/visualstudio/debugger/crt-debug-heap-details).
51+
For more information about heap state functions and the **`_CrtMemState`** structure, see [Heap State Reporting Functions](/visualstudio/debugger/crt-debug-heap-details). For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see [CRT Debug Heap Details](/visualstudio/debugger/crt-debug-heap-details).
5352

5453
## Requirements
5554

5655
|Routine|Required header|Optional header|
5756
|-------------|---------------------|---------------------|
58-
|**_CrtMemDifference**|\<crtdbg.h>|\<errno.h>|
57+
|**`_CrtMemDifference`**|`<crtdbg.h>`|`<errno.h>`|
5958

6059
For more compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
6160

62-
**Libraries:** Debug versions of [CRT Library Features](../../c-runtime-library/crt-library-features.md) only.
61+
**Libraries:** Debug versions of the [C runtime libraries](../../c-runtime-library/crt-library-features.md) only.
6362

6463
## See also
6564

66-
[Debug Routines](../../c-runtime-library/debug-routines.md)<br/>
67-
[_crtDbgFlag](../../c-runtime-library/crtdbgflag.md)<br/>
65+
[Debug Routines](../../c-runtime-library/debug-routines.md)\
66+
[`_crtDbgFlag`](../../c-runtime-library/crtdbgflag.md)\

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ For more information about heap state functions and the **_CrtMemState** structu
4343

4444
For more compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
4545

46-
**Libraries:** Debug versions of [CRT Library Features](../../c-runtime-library/crt-library-features.md) only.
46+
**Libraries:** Debug versions of the [C runtime libraries](../../c-runtime-library/crt-library-features.md) only.
4747

4848
## See also
4949

0 commit comments

Comments
 (0)