<table border="1" cellspacing="0" cellpadding="8">
    <tr>
        <th>Issue</th>
        <td>
            <a href=https://github.com/llvm/llvm-project/issues/59290>59290</a>
        </td>
    </tr>

    <tr>
        <th>Summary</th>
        <td>
            Add a documentation specifying the position of the libc project wrt wide chararacter and multibyte char support
        </td>
    </tr>

    <tr>
      <th>Labels</th>
      <td>
            documentation,
            libc
      </td>
    </tr>

    <tr>
      <th>Assignees</th>
      <td>
            michaelrj-google
      </td>
    </tr>

    <tr>
      <th>Reporter</th>
      <td>
          sivachandra
      </td>
    </tr>
</table>

<pre>
    We want to start with the position that:

1. Wide-char encoding will be that followed by the compiler. On most platforms it is UTF-32 and on Windows it is UTF-16.
2. Multi-byte to wide-char conversions assume utf-8 encoding of the multi-byte character strings irrespective of the current locale.
3. Wide-char to multi-byte conversions will convert to utf-8 encoded multi-byte strings irrespective of the current locale.
4. Explicit conversions will be as per the explicit expectation. For example, wide-char to `char16_t` string conversions will perform explicit conversion from the wide-char encoding to the UTF-16 encoding.
</pre>
<img width="1px" height="1px" alt="" src="http://email.email.llvm.org/o/eJyUU0FvozwQ_TXmMgoihpBw4NCv_XJb7WVXPa6MPYAr40H2EJp_v4LQJlVPe0ki2_Pey5v3VIy284i1OPwnpBys7hW68LbriDqHQkpxeEnUxD2FOtqL0r3yJqikIXOtXxFm5RmYILIKDLPlHrhHGClatuSBe8UifxLZi8i2z30Kr9bgTvcqAHpNxvoOZuscNLgOQEvO0YwGmusKp2kYrcOQwk8PA0WG0SluKQwRLION8PvXeZdLUN4AeXi13tD8eLcv0xu7TOHH5Njumivjonz-1KLJXzBESz6CinEaECZud6e7SGpXOcMdYBlUmjFA5GB9F8GGgHFEzfaCHwN6CgE9gyOtHG5K8kcfmL6gPihZjbkdrE4_SELzOPTPAooU_n8fndWWvzM2CCrCiGGdx493-L4gq2W3KZwpAL6rYVyS8vzgJBOIMlt-7ss_LMpsE_edZsSwrPFOcH8BbaBhZZ-_x4Vpvbmt9vM4TUydmyqvVIL1viyrSpZVUSZ9vc_bom2Ox_bY5qdCnkxRHU8Z5m15UlmlD4mtZSblXmZ7meWHokzzRsmq0iXm2Ulh0Ygiw0FZlzp3GVIKXWJjnLA-VLLKEqcadHGrkSE9DehvNi0dks9CSmcbvRUq1AvIrpm6KIrM2cjxDsuWHdZPxoCCL0iwbNW21_X_P5ZsW_JCAGOgN9QM81pHsyV0y-hSjzUxn9mFOI0jBU6m4OqeeYxLW-VZyHNnuZ-aVNMg5HlRt33tNgohz6sDUcjzasLfAAAA__-W8Hzq">