encodings

nimony/lib/std/encodings.nim

Routines for converting between different character encodings. On UNIX, this uses the iconv:idx: library, on Windows the Windows API.

On Android, iconv comes from Bionic's libc.so and is available from API 28. It only supports the UTF encodings, US-ASCII and WCHAR_T, so the default CP1252 source of open is not available there.

The following example shows how to change character encodings.

type EncodingConverter = ptr ConverterObj not nil
Can convert between two character sets.
proc getCurrentEncoding(uiApp: bool): string
Retrieves the current encoding. On Unix, "UTF-8" is always returned. The uiApp parameter is Windows specific. If true, the UI's code-page is returned, if false, the Console's code-page is returned.
proc open(destEncoding: string; srcEncoding: string): ptr ConverterObj not nil
Opens a converter that can convert from srcEncoding to destEncoding. Raises EncodingError if it cannot fulfill the request.
proc close(c: ptr ConverterObj not nil)
Frees the resources the converter c holds.
proc convert(c: ptr ConverterObj not nil; s: string): string
Converts s to destEncoding that was given to the converter c. It assumes that s is in srcEncoding.
.. warning:: UTF-16BE and UTF-32 conversions are not supported on Windows.
proc convert(s: string; destEncoding: string; srcEncoding: string): string
Converts s to destEncoding. It assumed that s is in srcEncoding. This opens a converter, uses it and closes it again and is thus more convenient but also likely less efficient than re-using a converter.
.. warning:: UTF-16BE and UTF-32 conversions are not supported on Windows.