Changeset 104773 in vbox for trunk/include

Timestamp:

May 24, 2024 12:56:32 PM (8 months ago)

Author:

vboxsync

Message:

Shared Clipboard: Make ShClUtf16LFLenUtf8 to provide proper length in characters for LF -> CRLF conversion, bugref:10694.

Also rename the function into ShClUtf16CalcNormalizedEolToCRLFLength and update documentation.

File:

• trunk/include/VBox/GuestHost/clipboard-helper.h (modified) (2 diffs)

trunk/include/VBox/GuestHost/clipboard-helper.h

@@ -62 +62 @@
 
 /**
- * Returns the length (in UTF-8 characters) of an UTF-16 string with LF EOL.
+ * Returns calculated length (in UTF-8 characters) of normalized UTF-16 string with CRLF EOL.
+ *
+ * This function should be used in order to calculate number of UTF-8 characters
+ * in normalized UTF-16. Normalized string is expected to have LF characters replaced
+ * with CRLF sequences.
  *
  * @returns VBox status code.
@@ -70 +74 @@
  *                              Does not include terminator.
  */
-int ShClUtf16LFLenUtf8(PCRTUTF16 pcwszSrc, size_t cwcSrc, size_t *pchLen);
+int ShClUtf16CalcNormalizedEolToCRLFLength(PCRTUTF16 pcwszSrc, size_t cwcSrc, size_t *pchLen);
 
 /**