Module Glib.Convert

Character Set Conversion @gtkdoc glib glib-Character-Set-Conversion

type error =
| NO_CONVERSION

Conversion between the requested character sets is not supported

| ILLEGAL_SEQUENCE

Invalid byte sequence in conversion input

| FAILED

Conversion failed for some reason

| PARTIAL_INPUT

Partial character sequence at end of input

| BAD_URI

URI is invalid

| NOT_ABSOLUTE_PATH

Pathname is not an absolute path

exception Error of error * string
val convert : string -> to_codeset:string -> from_codeset:string -> string
raises Error

.

val convert_with_fallback : ?⁠fallback:string -> to_codeset:string -> from_codeset:string -> string -> string
raises Error

.

raises Error

.

val locale_from_utf8 : string -> string

Converts the input string from UTF-8 to the encoding of the current locale. If the locale's encoding is UTF-8, the string is simply validated and returned unmodified.

raises Error

if the conversion fails

raises Error

if the string is not a valid UTF-8 string

val locale_to_utf8 : string -> string
raises Error

.

val filename_from_utf8 : string -> string
raises Error

.

val filename_to_utf8 : string -> string
raises Error

.

raises Error

.

val filename_from_uri : string -> string option * string
raises Error

.

raises Error

.

val filename_to_uri : ?⁠hostname:string -> string -> string
raises Error

.

raises Error

.

val get_charset : unit -> bool * string

Obtains the character set for the current locale.

returns

the pair u,s where u is true if the character set is UTF-8 and s is the character set name