System.Glib.UTFString

This module adds CString-like functions that handle UTF8 strings.

Documentation

withUTFString :: String -> (CString -> IO a) -> IO a

Like withCString but using the UTF-8 encoding.

withUTFStringLen :: String -> (CStringLen -> IO a) -> IO a

Like withCStringLen but using the UTF-8 encoding.

newUTFString :: String -> IO CString

Like newCString but using the UTF-8 encoding.

newUTFStringLen :: String -> IO CStringLen

Like Define newUTFStringLen to emit UTF-8.

peekUTFString :: CString -> IO String

Like peekCString but using the UTF-8 encoding.

peekUTFStringLen :: CStringLen -> IO String

Like peekCStringLen but using the UTF-8 encoding.

maybePeekUTFString :: CString -> IO (Maybe String)

Like maybePeek peekCString but using the UTF-8 encoding to retrieve UTF-8 from a CString which may be the nullPtr.

readUTFString :: CString -> IO String

Like like peekUTFString but then frees the string using g_free

readCString :: CString -> IO String

Like peekCString but then frees the string using g_free.

withUTFStrings :: [String] -> ([CString] -> IO a) -> IO a

Temporarily allocate a list of UTF-8 CStrings.

withUTFStringArray :: [String] -> (Ptr CString -> IO a) -> IO a

Temporarily allocate an array of UTF-8 encoded CStrings.

withUTFStringArray0 :: [String] -> (Ptr CString -> IO a) -> IO a

Temporarily allocate a null-terminated array of UTF-8 encoded CStrings.

peekUTFStringArray :: Int -> Ptr CString -> IO [String]

Convert an array (of the given length) of UTF-8 encoded CStrings to a list of Haskell Strings.

peekUTFStringArray0 :: Ptr CString -> IO [String]

Convert a null-terminated array of UTF-8 encoded CStrings to a list of Haskell Strings.

readUTFStringArray0 :: Ptr CString -> IO [String]

Like peekUTFStringArray0 but then free the string array including all strings.

To be used when functions indicate that their return value should be freed with g_strfreev.

data UTFCorrection

Offset correction for String to UTF8 mapping.

Instances

Show UTFCorrection

genUTFOfs :: String -> UTFCorrection

Create a list of offset corrections.

ofsToUTF :: Int -> UTFCorrection -> Int

ofsFromUTF :: Int -> UTFCorrection -> Int