mirror of
https://git.tartarus.org/simon/putty.git
synced 2025-01-09 17:38:00 +00:00
9e01de7c2b
Now you can optionally get back an enum value indicating whether the character was successfully decoded, or whether U+FFFD was substituted due to some kind of problem, and if the latter, what problem. For a start, this allows distinguishing 'real' U+FFFD (encoded legitimately in the input) from one invented by the decoder. Also, it allows the recipient of the decode to treat failures differently, either by passing on a useful error report to the user (as utf8_unknown_char now does) or by doing something special. In particular, there are two distinct error codes for a truncated UTF-8 encoding, depending on whether it was truncated by the end of the input or by encountering a non-continuation byte. The former code means that the string is not legal UTF-8 _as it is_, but doesn't rule out it being a (bytewise) prefix of a legal UTF-8 string - so if a client is receiving UTF-8 data a byte at a time, they can treat that error code specially and not make it a fatal error.
22 lines
555 B
C
22 lines
555 B
C
/*
|
|
* Decode a single UTF-8 character to the platform's local wchar_t.
|
|
*/
|
|
|
|
#include "putty.h"
|
|
#include "misc.h"
|
|
|
|
size_t decode_utf8_to_wchar(BinarySource *src, wchar_t *out,
|
|
DecodeUTF8Failure *err)
|
|
{
|
|
size_t outlen = 0;
|
|
unsigned wc = decode_utf8(src, err);
|
|
if (sizeof(wchar_t) > 2 || wc < 0x10000) {
|
|
out[outlen++] = wc;
|
|
} else {
|
|
unsigned wcoff = wc - 0x10000;
|
|
out[outlen++] = 0xD800 | (0x3FF & (wcoff >> 10));
|
|
out[outlen++] = 0xDC00 | (0x3FF & wcoff);
|
|
}
|
|
return outlen;
|
|
}
|