Most common encoding for strings in C++ in Linux (and Unix?)

Question

For creating a C++ program that is source code level portable between Windows and Linux and handles internationalization well, there are IMHO three main encodings to consider:

• The encoding of the C++ source code.
• The encoding of external data.
• The encoding(s) of strings and literals.

For the C++ source code there is not really any alternative to UTF-8 with BOM, at least if standard input and wide string literals should work on the Windows platform. UTF-8 without BOM causes Microsoft's Visual C++ compiler to assume Windows ANSI encoding for the source code, which is nice for UTF-8 output via std::cout, to the limited degree that that works (Windows console windows has lots of bugs here). However, then input via std::cin does not work.

And for the external data UTF-8 seems to be the de facto standard.

However, what about the internal literals and strings? Here I had the impression that narrow strings encoded as UTF-8 was the common convention in Linux. But recently two different persons have claimed otherwise, one claiming that the common convention for internal strings in international applications in Linux is UTF-32, and the other just claiming that there is some unspecified difference between Unix and Linux in this area.

As one who fiddles a little, on a hobby basis, with a micro-library intended to abstract away the Windows/Linux differences in this area, I … have to ask concretely

• what is the common Linux convention for representing strings in a program?

I am pretty sure that there is a common convention that is so overwhelmingly common that this question has a Real Answer™.

An example showing e.g. how to Linux-conventionally reverse a string (which is complex to do directly with UTF-8, but which presumably is done by functions that are de facto standard in Linux?), would also be nice, i.e., as a question, what is a Linux-conventional version of this C++ program (the code as given works for Latin-1 as the C++ narrow text execution character set):

#include <iostream>
#include <algorithm>
#include <string>
using namespace std;

#define STATIC_ASSERT( cond )   static_assert( cond, #cond )

int main()
{
    string line;
    if( getline( cin, line ) )
    {
        static char const aSingleChar[] = "æ";
        STATIC_ASSERT( sizeof( aSingleChar ) - 1 == 1 );
        reverse( line.begin(), line.end() );

        cout << line << endl;
    }
}

Answer 1

For external representations, UTF-8 is definitely the standard. Some 8-bit encodings are still strong (mostly in Europe) and some 16-bit encodings are still strong (mostly in East Asia), but they are clearly legacy encodings, on their slow way out. UTF-8 is standard not only on unix, but also on the web.

For internal representations, there's no such overwhelming standard. You'll find some UTF-8, some UCS-2, some UTF-16 and some UCS-4 if you look around.

• UTF-8 has the advantage that it matches the common representation, and that it's a superset of ASCII. In particular, it's the only encoding here where a null character corresponds to a null byte, which is important if you have C APIs around (including unix system calls and standard library functions).
• UCS-2 is a historical survivance. It was attractive because it was thought of as a fixed-width encoding, but it can't represent all of Unicode, which is a stopper.
• UTF-16's main claims to fame are Java and Windows APIs. Unix APIs (who like UTF-8) are more relevant than Windows APIs if you're programming for unix. Only programs geared towards interaction with APIs that like UTF-16 tend to use UTF-16.
• UCS-4 is attractive because it looks like a fixed-width encoding. The thing is, it isn't, really. Because of combining characters, there is no such thing as a fixed-width Unicode encoding.
• There's also wchar_t. The thing is, that's 2 bytes on some platforms, and 4 bytes on others, and the character set that it represents is not specificed. With Unicode being the de facto standard character set, newer applications tend to eschew wchar_t.

In the unix world, the argument that trumps them all is usually compatibility with unix APIs, pointing to UTF-8. It's not universal, however, so there's no yes-or-no answer to whether your library needs to support other encodings.

There's no difference between unix variants in that respect. Mac OS X prefers decomposed characters so as to have a normalized representation, so you might want to do that as well: it'll save some work on OSX and won't matter on other unices.

Note that there is no such thing as a BOM in UTF-8. A byte-order mark only makes sense for super-byte-sized encodings. The requirement that UTF-8-encoded files begin with the character U+FEFF is specific to a few Microsoft applications.

Answer 2

This is just a partial answer, since your question is fairly broad.

C++ defines an "execution character set" (in fact, two of them, a narrow and a wide one).

When your source file contains something like:

char s[] = "Hello";

Then the numeric byte value of the letters in the string literal are simply looked up according to the execution encoding. (The separate wide execution encoding applies to the numeric value assigned to wide character constants L'a'.)

All this happens as part of the initial reading of the source code file into the compilation process. Once inside, C++ characters are nothing more than bytes, with no attached semantics. (The type name char must be one of the most grievous misnomers in C-derived languages!)

There is a partial exception in C++11, where the literals u8"", u"" and U"" determine the resulting value of the string elements (i.e the resulting values are globally unambiguous and platform-independent), but that does not affect how the input source code is interpreted.

A good compiler should allow you to specify the source code encoding, so even if your friend on an EBCDIC machine sends you her program text, that shouldn't be a problem. GCC offers the following options:

• -finput-charset: input character set, i.e. how the source code file is encoded
• -fexec-charset: execution character set, i.e. how to encode string literals
• -fwide-exec-charset: wide execution character set, i.e. how to encode wide string literals

GCC uses iconv() for the conversions, so any encoding supported by iconv() can be used for those options.

I wrote previously about some opaque facilities provided by the C++ standard to handle text encodings.

---

Example: take the above code, char s[] = "Hello";. Suppose the source file is ASCII (i.e. the input encoding is ASCII). Then the compiler reads 99, and interprets it as c, and so on. When it comes to the literal, it reads 72, interprets it as H. Now it stores the byte value of H in the array which is determined by the execution encoding (again 72 if that is ASCII or UTF-8). When you write \xFF, the compiler reads 99 120 70 70, decodes it as \xFF, and writes 255 into the array.

Answer 3

one claiming that the common convention for internal strings in international applications in Linux is UTF-32

This is probably a reference to the fact that GCC defines wchar_t as a UTF-32 character, unlike Windows C(++) compilers that define wchar_t = UTF-16 (for compatibility with Windows WCHAR).

You could use wchar_t internally if that's convenient for you. However, it's not as common in the *nix world as in the Windows world, because the POSIX API was never rewritten to use wide characters like Windows was.

Using UTF-8 internally works well for routines that are "encoding-neutral". For example, consider a program to convert tab-separated spreadsheets to CSV. You'd need to treat the ASCII characters \t, ,, and " specially, but any bytes in the non-ASCII range (whether they represent ISO-8859-1 characters or UTF-8 code units) can simply be copied as-is.

As one who fiddles a little, on a hobby basis, with a micro-library intended to abstract away the Windows/Linux differences in this area,

One of the many annoyances of writing cross-platform code is that on Windows it's easy to use UTF-16 and hard to use UTF-8, but vice-versa on Linux. I've dealt with it by writing functions like this:

FILE* fopen_utf8(const char* filename, const char* mode)
{
#ifdef _WIN32
    std::wstring wfilename = ConvertUtf8ToUtf16(filename);
    std::wstring wmode = ConvertUtf8ToUtf16(mode);
    return _wfopen(wfilename.c_str(), wmode.c_str());
#else
    return fopen(filename, mode);
#endif
}