This class provides functions used to convert a non-ASCII C string given in ANSI, EUC, GB or SJIS format, to a Unicode string of extended characters, and vice versa. More...

#include <Resource_Unicode.hxx>

Static Public Member Functions
static void	ConvertSJISToUnicode (const Standard_CString fromstr, TCollection_ExtendedString &tostr)
	Converts non-ASCII CString <fromstr> in SJIS format to Unicode ExtendedString <tostr>.

static void	ConvertEUCToUnicode (const Standard_CString fromstr, TCollection_ExtendedString &tostr)
	Converts non-ASCII CString <fromstr> in EUC format to Unicode ExtendedString <tostr>.

static void	ConvertGBToUnicode (const Standard_CString fromstr, TCollection_ExtendedString &tostr)
	Converts non-ASCII CString <fromstr> in GB format to Unicode ExtendedString <tostr>.

static Standard_Boolean	ConvertGBKToUnicode (const Standard_CString fromstr, TCollection_ExtendedString &tostr)
	Converts non-ASCII CString <fromstr> in GBK format to Unicode ExtendedString <tostr>.

static Standard_Boolean	ConvertBig5ToUnicode (const Standard_CString fromstr, TCollection_ExtendedString &tostr)
	Converts non-ASCII CString <fromstr> in Big5 format to Unicode ExtendedString <tostr>.

static Standard_Boolean	ConvertUnicodeToSJIS (const TCollection_ExtendedString &fromstr, Standard_PCharacter &tostr, const Standard_Integer maxsize)
	Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in SJIS format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

static Standard_Boolean	ConvertUnicodeToEUC (const TCollection_ExtendedString &fromstr, Standard_PCharacter &tostr, const Standard_Integer maxsize)
	Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in EUC format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

static Standard_Boolean	ConvertUnicodeToGB (const TCollection_ExtendedString &fromstr, Standard_PCharacter &tostr, const Standard_Integer maxsize)
	Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in GB format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

static Standard_Boolean	ConvertUnicodeToANSI (const TCollection_ExtendedString &fromstr, Standard_PCharacter &tostr, const Standard_Integer maxsize)
	Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in ANSI format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

static void	SetFormat (const Resource_FormatType typecode)
	Defines the current conversion format as typecode. This conversion format will then be used by the functions ConvertFormatToUnicode and ConvertUnicodeToFormat to convert the strings.

static Resource_FormatType	GetFormat ()
	Returns the current conversion format (either ANSI, EUC, GB or SJIS). The current converting format must be defined in advance with the SetFormat function.

static void	ReadFormat ()
	Reads converting format from resource "FormatType" in Resource Manager "CharSet".

static void	ConvertFormatToUnicode (const Standard_CString theFromStr, TCollection_ExtendedString &theToStr)
	Converts the non-ASCII C string (as specified by GetFormat()) to the Unicode string of extended characters.

static void	ConvertFormatToUnicode (const Resource_FormatType theFormat, const Standard_CString theFromStr, TCollection_ExtendedString &theToStr)
	Converts the non-ASCII C string in specified format to the Unicode string of extended characters.

static Standard_Boolean	ConvertUnicodeToFormat (const Resource_FormatType theFormat, const TCollection_ExtendedString &theFromStr, Standard_PCharacter &theToStr, const Standard_Integer theMaxSize)
	Converts the Unicode string of extended characters to the non-ASCII string according to specified format. You need more than twice the length of the source string to complete the conversion. The function returns true if conversion is complete, i.e. the maximum number of characters is not reached before the end of conversion.

static Standard_Boolean	ConvertUnicodeToFormat (const TCollection_ExtendedString &theFromStr, Standard_PCharacter &theToStr, const Standard_Integer theMaxSize)
	Converts the Unicode string of extended characters to the non-ASCII string according to the format returned by the function GetFormat.

Detailed Description

This class provides functions used to convert a non-ASCII C string given in ANSI, EUC, GB or SJIS format, to a Unicode string of extended characters, and vice versa.

Member Function Documentation

◆ ConvertBig5ToUnicode()

static Standard_Boolean Resource_Unicode::ConvertBig5ToUnicode	(	const Standard_CString	fromstr,
		TCollection_ExtendedString &	tostr
	)

static

Converts non-ASCII CString <fromstr> in Big5 format to Unicode ExtendedString <tostr>.

◆ ConvertEUCToUnicode()

static void Resource_Unicode::ConvertEUCToUnicode	(	const Standard_CString	fromstr,
		TCollection_ExtendedString &	tostr
	)

static

Converts non-ASCII CString <fromstr> in EUC format to Unicode ExtendedString <tostr>.

◆ ConvertFormatToUnicode() [1/2]

static void Resource_Unicode::ConvertFormatToUnicode	(	const Resource_FormatType	theFormat,
		const Standard_CString	theFromStr,
		TCollection_ExtendedString &	theToStr
	)

static

Converts the non-ASCII C string in specified format to the Unicode string of extended characters.

Parameters

theFormat	[in] source encoding
theFromStr	[in] text to convert
theToStr	[out] destination string

◆ ConvertFormatToUnicode() [2/2]

static void Resource_Unicode::ConvertFormatToUnicode	(	const Standard_CString	theFromStr,
		TCollection_ExtendedString &	theToStr
	)

inlinestatic

Converts the non-ASCII C string (as specified by GetFormat()) to the Unicode string of extended characters.

◆ ConvertGBKToUnicode()

static Standard_Boolean Resource_Unicode::ConvertGBKToUnicode	(	const Standard_CString	fromstr,
		TCollection_ExtendedString &	tostr
	)

static

Converts non-ASCII CString <fromstr> in GBK format to Unicode ExtendedString <tostr>.

◆ ConvertGBToUnicode()

static void Resource_Unicode::ConvertGBToUnicode	(	const Standard_CString	fromstr,
		TCollection_ExtendedString &	tostr
	)

static

Converts non-ASCII CString <fromstr> in GB format to Unicode ExtendedString <tostr>.

◆ ConvertSJISToUnicode()

static void Resource_Unicode::ConvertSJISToUnicode	(	const Standard_CString	fromstr,
		TCollection_ExtendedString &	tostr
	)

static

Converts non-ASCII CString <fromstr> in SJIS format to Unicode ExtendedString <tostr>.

◆ ConvertUnicodeToANSI()

static Standard_Boolean Resource_Unicode::ConvertUnicodeToANSI	(	const TCollection_ExtendedString &	fromstr,
		Standard_PCharacter &	tostr,
		const Standard_Integer	maxsize
	)

static

Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in ANSI format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

◆ ConvertUnicodeToEUC()

static Standard_Boolean Resource_Unicode::ConvertUnicodeToEUC	(	const TCollection_ExtendedString &	fromstr,
		Standard_PCharacter &	tostr,
		const Standard_Integer	maxsize
	)

static

Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in EUC format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

◆ ConvertUnicodeToFormat() [1/2]

static Standard_Boolean Resource_Unicode::ConvertUnicodeToFormat	(	const Resource_FormatType	theFormat,
		const TCollection_ExtendedString &	theFromStr,
		Standard_PCharacter &	theToStr,
		const Standard_Integer	theMaxSize
	)

static

Converts the Unicode string of extended characters to the non-ASCII string according to specified format. You need more than twice the length of the source string to complete the conversion. The function returns true if conversion is complete, i.e. the maximum number of characters is not reached before the end of conversion.

Parameters

theFormat	[in] destination encoding
theFromStr	[in] text to convert
theToStr	[out] destination buffer
theMaxSize	[in] destination buffer length

◆ ConvertUnicodeToFormat() [2/2]

static Standard_Boolean Resource_Unicode::ConvertUnicodeToFormat	(	const TCollection_ExtendedString &	theFromStr,
		Standard_PCharacter &	theToStr,
		const Standard_Integer	theMaxSize
	)

inlinestatic

Converts the Unicode string of extended characters to the non-ASCII string according to the format returned by the function GetFormat.

Parameters

theFromStr	[in] text to convert
theToStr	[out] destination buffer
theMaxSize	[in] destination buffer length

◆ ConvertUnicodeToGB()

static Standard_Boolean Resource_Unicode::ConvertUnicodeToGB	(	const TCollection_ExtendedString &	fromstr,
		Standard_PCharacter &	tostr,
		const Standard_Integer	maxsize
	)

static

Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in GB format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

◆ ConvertUnicodeToSJIS()

static Standard_Boolean Resource_Unicode::ConvertUnicodeToSJIS	(	const TCollection_ExtendedString &	fromstr,
		Standard_PCharacter &	tostr,
		const Standard_Integer	maxsize
	)

static

Converts Unicode ExtendedString <fromstr> to non-ASCII CString <tostr> in SJIS format, limited to <maxsize> characters. To translate the whole <fromstr>, use more than twice the length of <fromstr>. Returns true if <maxsize> has not been reached before end of conversion.

◆ GetFormat()

static Resource_FormatType Resource_Unicode::GetFormat ( )

static

Returns the current conversion format (either ANSI, EUC, GB or SJIS). The current converting format must be defined in advance with the SetFormat function.

◆ ReadFormat()

static void Resource_Unicode::ReadFormat ( )

static

Reads converting format from resource "FormatType" in Resource Manager "CharSet".

◆ SetFormat()

static void Resource_Unicode::SetFormat ( const Resource_FormatType typecode )

static

Defines the current conversion format as typecode. This conversion format will then be used by the functions ConvertFormatToUnicode and ConvertUnicodeToFormat to convert the strings.

The documentation for this class was generated from the following file:

Resource_Unicode.hxx

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ ConvertBig5ToUnicode()

◆ ConvertEUCToUnicode()

◆ ConvertFormatToUnicode() [1/2]

◆ ConvertFormatToUnicode() [2/2]

◆ ConvertGBKToUnicode()

◆ ConvertGBToUnicode()

◆ ConvertSJISToUnicode()

◆ ConvertUnicodeToANSI()

◆ ConvertUnicodeToEUC()

◆ ConvertUnicodeToFormat() [1/2]

◆ ConvertUnicodeToFormat() [2/2]

◆ ConvertUnicodeToGB()

◆ ConvertUnicodeToSJIS()

◆ GetFormat()

◆ ReadFormat()

◆ SetFormat()