GetTextConverter Function

Creates a TextConverter object for converting between two encodings. It also works if the input encoding and output encoding are the same.

Syntax
result = GetTextConverter( inputEncoding, outputEncoding )

Parameters
inputEncoding | TextEncoding | Input text encoding.
outputEncoding | TextEncoding | Output text encoding.

Return Value
Result | TextConverter | Object of type TextConverter, used to perform conversion from InputEncoding to OutputEncoding.

# Notes

In REALbasic, every string may internally have a record of its encoding as well as the bytes that constitute its actual text. In many cases, the encoding is unknown, but any string returned by a TextConverter will have a known encoding, and so will be treated properly by EditFields and Graphics.DrawString. This is why it may sometimes be useful to get a TextConverter where the input and output encodings are the same; it provides a way to make sure that REALbasic knows what encoding a string represents.

# Example

The following example converts the text in an EditField:

Dim c as TextConverter
c=GetTextConverter( GetTextEncoding( &h500), GetTextEncoding(0))
EditField2.text=c.convert(EditField1.text)

# See Also

ConvertEncoding, DefineEncoding, Encoding, GetFontTextEncoding, GetInternetTextEncoding, GetTextEncoding functions; TextConverter, TextEncoding classes.