ntdll: Add some documentation for ntdll_umbstowcs() and ntdll_wcstoumbs().

These functions do match e.g. mbstowcs() and MultiByteToWideChar(), but that fact is not inherently obvious [and they don't match RtlMultiByteToUnicodeN(), for example.]

ntdll: Add some documentation for ntdll_umbstowcs() and ntdll_wcstoumbs().
88b77020 · Zebediah Figura · Alexandre Julliard · 23d85e6e · 88b77020
Commit 88b77020 authored Jun 22, 2022 by Zebediah Figura Committed by Alexandre Julliard Jun 27, 2022
Hide whitespace changes
Inline Side-by-side

Showing with 12 additions and 0 deletions

env.c dlls/ntdll/unix/env.c +12 -0

No files found.
--- a/dlls/ntdll/unix/env.c
+++ b/dlls/ntdll/unix/env.c
@@ -364,6 +364,13 @@ static BOOL is_dynamic_env_var( const char *var )

 /******************************************************************
 *      ntdll_umbstowcs  (ntdll.so)
+ *
+ * Convert a multi-byte string in the Unix code page to UTF-16. Returns the
+ * number of characters converted, which may be less than the entire source
+ * string. The destination string must not be NULL.
+ *
+ * The size of the output buffer, and the return value, are both given in
+ * characters, not bytes.
 */
 DWORD ntdll_umbstowcs( const char *src, DWORD srclen, WCHAR *dst, DWORD dstlen )
 {
@@ -381,6 +388,11 @@ DWORD ntdll_umbstowcs( const char *src, DWORD srclen, WCHAR *dst, DWORD dstlen )

 /******************************************************************
 *      ntdll_wcstoumbs  (ntdll.so)
+ *
+ * Convert a UTF-16 string to a multi-byte string in the Unix code page.
+ * The destination string must not be NULL.
+ *
+ * The size of the source string is given in characters, not bytes.
 */
 int ntdll_wcstoumbs( const WCHAR *src, DWORD srclen, char *dst, DWORD dstlen, BOOL strict )
 {