Google

logo top
Main Page   Widgets   Namespaces   Book  

Character Set Conversion

Utility functions for converting strings between different character sets. More...

Compounds

class  ConvertError
 Exception class for charset conversion errors. More...

class  IConv
 Thin iconv() wrapper. More...


Functions

bool get_charset ()
 Get the charset used by the current locale.

bool get_charset (std::string& charset)
 Get the charset used by the current locale.

std::string convert (const std::string& str, const std::string& to_codeset, const std::string& from_codeset)
 Convert from one encoding to another.

std::string convert_with_fallback (const std::string& str, const std::string& to_codeset, const std::string& from_codeset)
 Converts a string from one character set to another, possibly including fallback sequences for characters not representable in the output.

std::string convert_with_fallback (const std::string& str, const std::string& to_codeset, const std::string& from_codeset, const Glib::ustring& fallback)
 Converts a string from one character set to another, possibly including fallback sequences for characters not representable in the output.

Glib::ustring locale_to_utf8 (const std::string& opsys_string)
 Convert from the current locale's encoding to UTF-8.

std::string locale_from_utf8 (const Glib::ustring& utf8_string)
 Convert from UTF-8 to the current locale's encoding.

Glib::ustring filename_to_utf8 (const std::string& opsys_string)
 Converts a string which is in the encoding used for filenames into a UTF-8 string.

std::string filename_from_utf8 (const Glib::ustring& utf8_string)
 Converts a string from UTF-8 to the encoding used for filenames.

std::string filename_from_uri (const Glib::ustring& uri, Glib::ustring& hostname)
 Converts an escaped UTF-8 encoded URI to a local filename in the encoding used for filenames.

std::string filename_from_uri (const Glib::ustring& uri)
 Converts an escaped UTF-8 encoded URI to a local filename in the encoding used for filenames.

Glib::ustring filename_to_uri (const std::string& filename, const Glib::ustring& hostname)
 Converts an absolute filename to an escaped UTF-8 encoded URI.

Glib::ustring filename_to_uri (const std::string& filename)
 Converts an absolute filename to an escaped UTF-8 encoded URI.


Detailed Description

Utility functions for converting strings between different character sets.


Function Documentation

std::string convert ( const std::string&    str,
const std::string&    to_codeset,
const std::string&    from_codeset
 

Convert from one encoding to another.

Parameters:
str The string to convert.
to_codeset Name of the target charset.
from_codeset Name of the source charset.
Returns:
The converted string.
Exceptions:
Glib::ConvertError 

std::string convert_with_fallback ( const std::string&    str,
const std::string&    to_codeset,
const std::string&    from_codeset,
const Glib::ustring   fallback
 

Converts a string from one character set to another, possibly including fallback sequences for characters not representable in the output.

Note:
It is not guaranteed that the specification for the fallback sequences in fallback will be honored. Some systems may do a approximate conversion from from_codeset to to_codeset in their iconv() functions, in which case Glib will simply return that approximate conversion.
Parameters:
str The string to convert.
to_codeset Name of the target charset.
from_codeset Name of the source charset.
fallback UTF-8 string to be used in place of characters which aren't available in the target encoding. All characters in the fallback string must be available in the target encoding.
Returns:
The converted string.
Exceptions:
Glib::ConvertError 

std::string convert_with_fallback ( const std::string&    str,
const std::string&    to_codeset,
const std::string&    from_codeset
 

Converts a string from one character set to another, possibly including fallback sequences for characters not representable in the output.

Characters not in the target encoding will be represented as Unicode escapes \x{XXXX} or \x{XXXXXX}.

Parameters:
str The string to convert.
to_codeset Name of the target charset.
from_codeset Name of the source charset.
Returns:
The converted string.
Exceptions:
Glib::ConvertError 

std::string filename_from_uri ( const Glib::ustring   uri
 

Converts an escaped UTF-8 encoded URI to a local filename in the encoding used for filenames.

Parameters:
uri A string in the encoding for filenames.
Returns:
The resulting filename.
Exceptions:
Glib::ConvertError 

std::string filename_from_uri ( const Glib::ustring   uri,
Glib::ustring   hostname
 

Converts an escaped UTF-8 encoded URI to a local filename in the encoding used for filenames.

Parameters:
uri A string in the encoding for filenames.
hostname Location to store hostname for the URI. If there is no hostname in the URI, "" will be stored in this location.
Returns:
The resulting filename.
Exceptions:
Glib::ConvertError 

std::string filename_from_utf8 ( const Glib::ustring   utf8_string
 

Converts a string from UTF-8 to the encoding used for filenames.

Parameters:
utf8_string A UTF-8 encoded string.
Returns:
The converted string.
Exceptions:
Glib::ConvertError 

Glib::ustring filename_to_uri ( const std::string&    filename
 

Converts an absolute filename to an escaped UTF-8 encoded URI.

Parameters:
filename An absolute filename specified in the encoding used for filenames by the operating system.
Returns:
The resulting URI.
Exceptions:
Glib::ConvertError 

Glib::ustring filename_to_uri ( const std::string&    filename,
const Glib::ustring   hostname
 

Converts an absolute filename to an escaped UTF-8 encoded URI.

Parameters:
filename An absolute filename specified in the encoding used for filenames by the operating system.
hostname A UTF-8 encoded hostname.
Returns:
The resulting URI.
Exceptions:
Glib::ConvertError 

Glib::ustring filename_to_utf8 ( const std::string&    opsys_string
 

Converts a string which is in the encoding used for filenames into a UTF-8 string.

Parameters:
opsys_string A string in the encoding for filenames.
Returns:
The converted string.
Exceptions:
Glib::ConvertError 

bool get_charset ( std::string&    charset
 

Get the charset used by the current locale.

Parameters:
charset Will be filled with the charset's name.
Returns:
Whether the current locale uses the UTF-8 charset.

bool get_charset (  
 

Get the charset used by the current locale.

Returns:
Whether the current locale uses the UTF-8 charset.

std::string locale_from_utf8 ( const Glib::ustring   utf8_string
 

Convert from UTF-8 to the current locale's encoding.

Convenience wrapper around Glib::convert().

Parameters:
utf8_string The UTF-8 string to convert.
Returns:
The input string converted to the charset used by the operating system's current locale.
Exceptions:
Glib::ConvertError 

Glib::ustring locale_to_utf8 ( const std::string&    opsys_string
 

Convert from the current locale's encoding to UTF-8.

Convenience wrapper around Glib::convert().

Parameters:
opsys_string The string to convert. Must be encoded in the charset used by the operating system's current locale.
Returns:
The input string converted to UTF-8 encoding.
Exceptions:
Glib::ConvertError 


Generated for gtkmm by Doxygen 1.3-rc1 © 1997-2001