Skip to content

Commit f1b89fe

Browse files
authored
Merge pull request #4160 from MicrosoftDocs/main637986008913473606sync_temp
Repo sync for protected CLA branch
2 parents b8b6b28 + 9067316 commit f1b89fe

File tree

1 file changed

+18
-15
lines changed

1 file changed

+18
-15
lines changed

docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md

Lines changed: 18 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l"
33
title: "vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l"
4-
ms.date: "3/9/2021"
4+
ms.date: 09/09/2022
55
api_name: ["_vsnwprintf_s", "_vsnwprintf_s_l", "_vsnprintf_s", "vsnprintf_s", "_vsnprintf_s_l"]
66
api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"]
77
api_type: ["DLLExport"]
@@ -71,25 +71,25 @@ int _vsnwprintf_s(
7171

7272
### Parameters
7373

74-
*`buffer`*<br/>
74+
*`buffer`*\
7575
Storage location for output.
7676

77-
*`sizeOfBuffer`*<br/>
77+
*`sizeOfBuffer`*\
7878
The size of the *`buffer`* for output, as the character count.
7979

80-
*`count`*<br/>
80+
*`count`*\
8181
Maximum number of characters to write (not including the terminating null), or [`_TRUNCATE`](../../c-runtime-library/truncate.md).
8282

83-
*`format`*<br/>
83+
*`format`*\
8484
Format specification.
8585

86-
*`argptr`*<br/>
86+
*`argptr`*\
8787
Pointer to list of arguments.
8888

89-
*`locale`*<br/>
89+
*`locale`*\
9090
The locale to use.
9191

92-
For more information, see [Format Specifications](../../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md).
92+
For more information, see [Format specifications](../../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md).
9393

9494
## Return Value
9595

@@ -135,6 +135,9 @@ The versions of these functions with the **`_l`** suffix are identical except th
135135
136136
In C++, using these functions is simplified by template overloads; the overloads can infer buffer length automatically (eliminating the need to specify a size argument) and they can automatically replace older, non-secure functions with their newer, secure counterparts. For more information, see [Secure Template Overloads](../../c-runtime-library/secure-template-overloads.md).
137137

138+
> [!Tip]
139+
> If you get an undefined external `_vsnprintf_s` error and are using the Universal C Runtime, add `legacy_stdio_definitions.lib` to the set of libraries to link with. The Universal C Runtime doesn't export this function directly and is instead defined inline in `<stdio.h>`. For more information, see [Overview of potential upgrade issues](/cpp/porting/overview-of-potential-upgrade-issues-visual-cpp.md#libraries) and [Visual Studio 2015 Conformance Changes](/cpp/porting/visual-cpp-change-history-2003-2015.md#stdio_and_conio).
140+
138141
### Generic-Text Routine Mappings
139142

140143
|`TCHAR.H` routine|`_UNICODE` & `_MBCS` not defined|`_MBCS` defined|`_UNICODE` defined|
@@ -152,7 +155,7 @@ In C++, using these functions is simplified by template overloads; the overloads
152155

153156
\* Required for UNIX V compatibility.
154157

155-
For additional compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
158+
For more compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
156159

157160
## Example
158161

@@ -188,9 +191,9 @@ nSize: -1, buff: Hi there!
188191

189192
## See also
190193

191-
[Stream I/O](../../c-runtime-library/stream-i-o.md)<br/>
192-
[`vprintf` Functions](../../c-runtime-library/vprintf-functions.md)<br/>
193-
[`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)<br/>
194-
[`printf`, `_printf_l`, `wprintf`, `_wprintf_l`](printf-printf-l-wprintf-wprintf-l.md)<br/>
195-
[`sprintf`, `_sprintf_l`, `swprintf`, `_swprintf_l`, `__swprintf_l`](sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md)<br/>
196-
[`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md)<br/>
194+
[Stream I/O](../../c-runtime-library/stream-i-o.md)\
195+
[`vprintf` Functions](../../c-runtime-library/vprintf-functions.md)\
196+
[`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)\
197+
[`printf`, `_printf_l`, `wprintf`, `_wprintf_l`](printf-printf-l-wprintf-wprintf-l.md)\
198+
[`sprintf`, `_sprintf_l`, `swprintf`, `_swprintf_l`, `__swprintf_l`](sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md)\
199+
[`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md)\

0 commit comments

Comments
 (0)