Skip to content

Commit 0439d48

Browse files
authored
Merge pull request #5543 from MicrosoftDocs/FromPublicMasterBranch
Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main)
2 parents 4771ca2 + 0680329 commit 0439d48

21 files changed

+39
-60
lines changed

docs/c-runtime-library/byte-and-wide-streams.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,15 +4,14 @@ description: "An overview of byte streams in the Microsoft C runtime library."
44
ms.date: "11/04/2016"
55
ms.topic: "conceptual"
66
helpviewer_keywords: ["byte streams", "wide streams"]
7-
ms.assetid: 61ef0587-4cbc-4eb8-aae5-4c298dbbc6f9
87
---
98
# Byte and wide streams
109

1110
A byte stream treats a file as a sequence of bytes. Within the program, the stream is the identical sequence of bytes.
1211

1312
By contrast, a wide stream treats a file as a sequence of generalized multibyte characters, which can have a broad range of encoding rules. (Text and binary files are still read and written as previously described.) Within the program, the stream looks like the corresponding sequence of wide characters. Conversions between the two representations occur within the Standard C Library. The conversion rules can, in principle, be altered by a call to [`setlocale`](./reference/setlocale-wsetlocale.md) that alters the category `LC_CTYPE`. Each wide stream determines its conversion rules at the time it becomes wide oriented, and retains these rules even if the category `LC_CTYPE` later changes.
1413

15-
Positioning within a wide stream suffers the same limitations as for text steams. Moreover, the file-position indicator may well have to deal with a state-dependent encoding. Typically, it includes both a byte offset within the stream and an object of type `mbstate_t`. Thus, the only reliable way to obtain a file position within a wide stream is by calling [`fgetpos`](./reference/fgetpos.md), and the only reliable way to restore a position obtained this way is by calling [`fsetpos`](./reference/fsetpos.md).
14+
Positioning within a wide stream suffers the same limitations as for text streams. Moreover, the file-position indicator may well have to deal with a state-dependent encoding. Typically, it includes both a byte offset within the stream and an object of type `mbstate_t`. Thus, the only reliable way to obtain a file position within a wide stream is by calling [`fgetpos`](./reference/fgetpos.md), and the only reliable way to restore a position obtained this way is by calling [`fsetpos`](./reference/fsetpos.md).
1615

1716
## See also
1817

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fclose_nolock"
32
title: "_fclose_nolock"
3+
description: "Learn more about: _fclose_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fclose_nolock", "_o__fclose_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["fclose_nolock", "_fclose_nolock"]
1010
helpviewer_keywords: ["streams, closing", "fclose_nolock function", "_fclose_nolock function"]
11-
ms.assetid: b4af4392-5fc8-49bb-9fe2-ca7293d3ce04
1211
---
1312
# `_fclose_nolock`
1413

15-
Closes a stream without thread-locking.
14+
Closes a stream without locking.
1615

1716
## Syntax
1817

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fflush_nolock"
32
title: "_fflush_nolock"
3+
description: "Learn more about: _fflush_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fflush_nolock", "_o__fflush_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["fflush_nolock", "_fflush_nolock"]
1010
helpviewer_keywords: ["fflush_nolock function", "_fflush_nolock function", "streams, flushing", "flushing"]
11-
ms.assetid: 5e33c4a1-b10c-4001-ad01-210757919291
1211
---
1312
# `_fflush_nolock`
1413

15-
Flushes a stream without locking the thread.
14+
Flushes a stream without locking.
1615

1716
## Syntax
1817

docs/c-runtime-library/reference/fgetc-nolock-fgetwc-nolock.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fgetc_nolock, _fgetwc_nolock"
32
title: "_fgetc_nolock, _fgetwc_nolock"
3+
description: "Learn more about: _fgetc_nolock, _fgetwc_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fgetc_nolock", "_fgetwc_nolock", "_o__fgetc_nolock", "_o__fgetwc_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fgetwc_nolock", "fgettc_nolock", "fgetwc_nolock", "_fgetc_nolock", "_fgettc_nolock", "fgetc_nolock"]
1010
helpviewer_keywords: ["fgetc_nolock function", "fgetwc_nolock function", "_fgetwc_nolock function", "characters, reading", "_fgetc_nolock function", "streams, reading characters from", "fgettc_nolock function", "reading characters from streams", "_fgettc_nolock function"]
11-
ms.assetid: fb8e7c5b-4503-493a-879e-6a1db75aa114
1211
---
1312
# `_fgetc_nolock`, `_fgetwc_nolock`
1413

15-
Reads a character from a stream without locking the thread.
14+
Reads a character from a stream without locking.
1615

1716
## Syntax
1817

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fputc_nolock, _fputwc_nolock"
32
title: "_fputc_nolock, _fputwc_nolock"
3+
description: "Learn more about: _fputc_nolock, _fputwc_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fputwc_nolock", "_fputc_nolock", "_o__fputc_nolock", "_o__fputwc_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fputc_nolock", "fputwc_nolock", "fputc_nolock", "fputtc_nolock", "_fputwc_nolock", "_fputtc_nolock"]
1010
helpviewer_keywords: ["streams, writing characters to", "fputwc_nolock function", "fputtc_nolock function", "_fputc_nolock function", "fputc_nolock function", "_fputtc_nolock function", "_fputwc_nolock function"]
11-
ms.assetid: c63eb3ad-58fa-46d0-9249-9c25f815eab9
1211
---
1312
# `_fputc_nolock`, `_fputwc_nolock`
1413

15-
Writes a character to a stream without locking the thread.
14+
Writes a character to a stream without locking.
1615

1716
## Syntax
1817

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,16 @@
11
---
2-
description: "Learn more about: _fread_nolock_s"
32
title: "_fread_nolock_s2"
3+
description: "Learn more about: _fread_nolock_s"
44
ms.date: "4/2/2020"
55
api_name: ["_fread_nolock_s", "_o__fread_nolock_s"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fread_nolock_s", "stdio/_fread_nolock_s"]
10-
ms.assetid: 5badb9ab-11df-4e17-8162-30bda2a4572e
1110
---
1211
# `_fread_nolock_s`
1312

14-
Reads data from a stream, without locking other threads. This version of [`fread_nolock`](fread-nolock.md) has security enhancements, as described in [Security features in the CRT](../security-features-in-the-crt.md).
13+
Reads data from a stream without locking. This version of [`fread_nolock`](fread-nolock.md) has security enhancements, as described in [Security features in the CRT](../security-features-in-the-crt.md).
1514

1615
## Syntax
1716

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fread_nolock"
32
title: "_fread_nolock"
3+
description: "Learn more about: _fread_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fread_nolock", "_o__fread_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fread_nolock", "fread_nolock"]
1010
helpviewer_keywords: ["reading data [C++], from input streams", "data [C++], reading from input stream", "fread_nolock function", "_fread_nolock function", "streams [C++], reading data from"]
11-
ms.assetid: 60e4958b-1097-46f5-a77b-94af5e7dba40
1211
---
1312
# `_fread_nolock`
1413

15-
Reads data from a stream, without locking other threads.
14+
Reads data from a stream without locking.
1615

1716
## Syntax
1817

docs/c-runtime-library/reference/fseek-nolock-fseeki64-nolock.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fseek_nolock, _fseeki64_nolock"
32
title: "_fseek_nolock, _fseeki64_nolock"
3+
description: "Learn more about: _fseek_nolock, _fseeki64_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fseek_nolock", "_fseeki64_nolock", "_o__fseek_nolock", "_o__fseeki64_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fseek_nolock", "_fseeki64_nolock", "fseek_nolock", "fseeki64_nolock"]
1010
helpviewer_keywords: ["_fseek_nolock function", "fseeki64_nolock function", "file pointers [C++], moving", "fseek_nolock function", "_fseeki64_nolock function", "seek file pointers"]
11-
ms.assetid: 2dd4022e-b715-462b-b935-837561605a02
1211
---
1312
# `_fseek_nolock`, `_fseeki64_nolock`
1413

15-
Moves the file pointer to a specified location.
14+
Moves the file pointer to a specified location without locking.
1615

1716
## Syntax
1817

docs/c-runtime-library/reference/ftell-nolock-ftelli64-nolock.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _ftell_nolock, _ftelli64_nolock"
32
title: "_ftell_nolock, _ftelli64_nolock"
3+
description: "Learn more about: _ftell_nolock, _ftelli64_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_ftelli64_nolock", "_ftell_nolock", "_o__ftell_nolock", "_o__ftelli64_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_ftelli64_nolock", "ftelli64_nolock", "ftell_nolock", "_ftell_nolock"]
1010
helpviewer_keywords: ["ftelli64_nolock function", "_ftelli64_nolock function", "_ftell_nolock function", "ftell_nolock function", "file pointers [C++], getting current position"]
11-
ms.assetid: 84e68b0a-32f8-4c4a-90ad-3f2387685ede
1211
---
1312
# `_ftell_nolock`, `_ftelli64_nolock`
1413

15-
Gets the current position of a file pointer, without locking the thread.
14+
Gets the current position of a file pointer without locking.
1615

1716
## Syntax
1817

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

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,17 @@
11
---
2-
description: "Learn more about: _fwrite_nolock"
32
title: "_fwrite_nolock"
3+
description: "Learn more about: _fwrite_nolock"
44
ms.date: "4/2/2020"
55
api_name: ["_fwrite_nolock", "_o__fwrite_nolock"]
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", "api-ms-win-crt-stdio-l1-1-0.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_fwrite_nolock", "fwrite_nolock"]
1010
helpviewer_keywords: ["fwrite_nolock function", "streams, writing data to", "_fwrite_nolock function"]
11-
ms.assetid: 2b4ec6ce-742e-4615-8407-44a0a18ec1d7
1211
---
1312
# `_fwrite_nolock`
1413

15-
Writes data to a stream, without locking the thread.
14+
Writes data to a stream without locking.
1615

1716
## Syntax
1817

0 commit comments

Comments
 (0)