Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 8.2   8.3   8.4   8.5   9.0   9.1   9.2   9.3   9.4   9.5    Statistic  

Text.ConvertToTextEncoding

Converts text into a text encoding.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
Text 9.4 Yes Yes Yes Yes Yes
MBS( "Text.ConvertToTextEncoding"; Text; Encoding )   More

Parameters

Parameter Description Example value
Text The text to convert. "Hello World"
Encoding The desired encoding.
Maybe appended by //TRANSLIT or //IGNORE to reduce number of errros.
"UTF8//TRANSLIT"

Result

Returns hex text or error.

Description

Converts text into a text encoding.
Returns text in hex encoded bytes.
As we use iconv library here, we can handle many more encodings than the standard FileMaker text functions used within the plugin.

If the string //IGNORE is appended to to-encoding, characters that cannot be converted are discarded and an error is printed after conversion.

If the string //TRANSLIT is appended to to-encoding, characters being converted are transliterated when needed and possible. This means that when a character cannot be represented in the target character set, it can be approximated through one or several similar looking characters. Characters that are outside of the target character set and cannot be transliterated are replaced with a question mark (?) in the output.

Encoding list with alternative names:

  • ANSI_X3.4-1968,ANSI_X3.4-1986,ASCII,CP367,IBM367,ISO-IR-6,ISO646-US,ISO_646.IRV:1991,US,US-ASCII,CSASCII
  • UTF-8
  • ISO-10646-UCS-2,UCS-2,CSUNICODE
  • UCS-2BE,UNICODE-1-1,UNICODEBIG,CSUNICODE11
  • UCS-2LE,UNICODELITTLE
  • ISO-10646-UCS-4,UCS-4,CSUCS4
  • UCS-4BE
  • UCS-4LE
  • UTF-16
  • UTF-16BE
  • UTF-16LE
  • UTF-32
  • UTF-32BE
  • UTF-32LE
  • UNICODE-1-1-UTF-7,UTF-7,CSUNICODE11UTF7
  • UCS-2-INTERNAL
  • UCS-2-SWAPPED
  • UCS-4-INTERNAL
  • UCS-4-SWAPPED
  • C99
  • JAVA
  • CP819,IBM819,ISO-8859-1,ISO-IR-100,ISO8859-1,ISO_8859-1,ISO_8859-1:1987,L1,LATIN1,CSISOLATIN1
  • ISO-8859-2,ISO-IR-101,ISO8859-2,ISO_8859-2,ISO_8859-2:1987,L2,LATIN2,CSISOLATIN2
  • ISO-8859-3,ISO-IR-109,ISO8859-3,ISO_8859-3,ISO_8859-3:1988,L3,LATIN3,CSISOLATIN3
  • ISO-8859-4,ISO-IR-110,ISO8859-4,ISO_8859-4,ISO_8859-4:1988,L4,LATIN4,CSISOLATIN4
  • CYRILLIC,ISO-8859-5,ISO-IR-144,ISO8859-5,ISO_8859-5,ISO_8859-5:1988,CSISOLATINCYRILLIC
  • ARABIC,ASMO-708,ECMA-114,ISO-8859-6,ISO-IR-127,ISO8859-6,ISO_8859-6,ISO_8859-6:1987,CSISOLATINARABIC
  • ECMA-118,ELOT_928,GREEK,GREEK8,ISO-8859-7,ISO-IR-126,ISO8859-7,ISO_8859-7,ISO_8859-7:1987,ISO_8859-7:2003,CSISOLATINGREEK
  • HEBREW,ISO-8859-8,ISO-IR-138,ISO8859-8,ISO_8859-8,ISO_8859-8:1988,CSISOLATINHEBREW
  • ISO-8859-9,ISO-IR-148,ISO8859-9,ISO_8859-9,ISO_8859-9:1989,L5,LATIN5,CSISOLATIN5
  • ISO-8859-10,ISO-IR-157,ISO8859-10,ISO_8859-10,ISO_8859-10:1992,L6,LATIN6,CSISOLATIN6
  • ISO-8859-11,ISO8859-11,ISO_8859-11
  • ISO-8859-13,ISO-IR-179,ISO8859-13,ISO_8859-13,L7,LATIN7
  • ISO-8859-14,ISO-CELTIC,ISO-IR-199,ISO8859-14,ISO_8859-14,ISO_8859-14:1998,L8,LATIN8
  • ISO-8859-15,ISO-IR-203,ISO8859-15,ISO_8859-15,ISO_8859-15:1998,LATIN-9
  • ISO-8859-16,ISO-IR-226,ISO8859-16,ISO_8859-16,ISO_8859-16:2001,L10,LATIN10
  • KOI8-R,CSKOI8R
  • KOI8-U
  • KOI8-RU
  • CP1250,MS-EE,WINDOWS-1250
  • CP1251,MS-CYRL,WINDOWS-1251
  • CP1252,MS-ANSI,WINDOWS-1252
  • CP1253,MS-GREEK,WINDOWS-1253
  • CP1254,MS-TURK,WINDOWS-1254
  • CP1255,MS-HEBR,WINDOWS-1255
  • CP1256,MS-ARAB,WINDOWS-1256
  • CP1257,WINBALTRIM,WINDOWS-1257
  • CP1258,WINDOWS-1258
  • 850,CP850,IBM850,CSPC850MULTILINGUAL
  • 862,CP862,IBM862,CSPC862LATINHEBREW
  • 866,CP866,IBM866,CSIBM866
  • CP1131
  • MAC,MACINTOSH,MACROMAN,CSMACINTOSH
  • MACCENTRALEUROPE
  • MACICELAND
  • MACCROATIAN
  • MACROMANIA
  • MACCYRILLIC
  • MACUKRAINE
  • MACGREEK
  • MACTURKISH
  • MACHEBREW
  • MACARABIC
  • MACTHAI
  • HP-ROMAN8,R8,ROMAN8,CSHPROMAN8
  • NEXTSTEP
  • ARMSCII-8
  • GEORGIAN-ACADEMY
  • GEORGIAN-PS
  • KOI8-T
  • CP154,CYRILLIC-ASIAN,PT154,PTCP154,CSPTCP154
  • KZ-1048,RK1048,STRK1048-2002,CSKZ1048
  • MULELAO-1
  • CP1133,IBM-CP1133
  • ISO-IR-166,TIS-620,TIS620,TIS620-0,TIS620.2529-1,TIS620.2533-0,TIS620.2533-1
  • CP874,WINDOWS-874
  • VISCII,VISCII1.1-1,CSVISCII
  • TCVN,TCVN-5712,TCVN5712-1,TCVN5712-1:1993
  • ISO-IR-14,ISO646-JP,JIS_C6220-1969-RO,JP,CSISO14JISC6220RO
  • JISX0201-1976,JIS_X0201,X0201,CSHALFWIDTHKATAKANA
  • ISO-IR-87,JIS0208,JIS_C6226-1983,JIS_X0208,JIS_X0208-1983,JIS_X0208-1990,X0208,CSISO87JISX0208
  • ISO-IR-159,JIS_X0212,JIS_X0212-1990,JIS_X0212.1990-0,X0212,CSISO159JISX02121990
  • CN,GB_1988-80,ISO-IR-57,ISO646-CN,CSISO57GB1988
  • CHINESE,GB_2312-80,ISO-IR-58,CSISO58GB231280
  • CN-GB-ISOIR165,ISO-IR-165
  • ISO-IR-149,KOREAN,KSC_5601,KS_C_5601-1987,KS_C_5601-1989,CSKSC56011987
  • EUC-JP,EUCJP,EXTENDED_UNIX_CODE_PACKED_FORMAT_FOR_JAPANESE,CSEUCPKDFMTJAPANESE
  • MS_KANJI,SHIFT-JIS,SHIFT_JIS,SJIS,CSSHIFTJIS
  • CP932
  • ISO-2022-JP,CSISO2022JP
  • ISO-2022-JP-1
  • ISO-2022-JP-2,CSISO2022JP2
  • CP50221,ISO-2022-JP-MS
  • CN-GB,EUC-CN,EUCCN,GB2312,CSGB2312
  • GBK
  • CP936,MS936,WINDOWS-936
  • GB18030
  • ISO-2022-CN,CSISO2022CN
  • ISO-2022-CN-EXT
  • HZ,HZ-GB-2312
  • EUC-TW,EUCTW,CSEUCTW
  • BIG-5,BIG-FIVE,BIG5,BIGFIVE,CN-BIG5,CSBIG5
  • CP950
  • BIG5-HKSCS:1999
  • BIG5-HKSCS:2001
  • BIG5-HKSCS:2004
  • BIG5-HKSCS,BIG5-HKSCS:2008,BIG5HKSCS
  • EUC-KR,EUCKR,CSEUCKR
  • CP949,UHC
  • CP1361,JOHAB
  • ISO-2022-KR,CSISO2022KR
  • CP856
  • CP922
  • CP943
  • CP1046
  • CP1124
  • CP1129
  • CP1161,IBM-1161,IBM1161,CSIBM1161
  • CP1162,IBM-1162,IBM1162,CSIBM1162
  • CP1163,IBM-1163,IBM1163,CSIBM1163
  • DEC-KANJI
  • DEC-HANYU
  • 437,CP437,IBM437,CSPC8CODEPAGE437
  • CP737
  • CP775,IBM775,CSPC775BALTIC
  • 852,CP852,IBM852,CSPCP852
  • CP853
  • 855,CP855,IBM855,CSIBM855
  • 857,CP857,IBM857,CSIBM857
  • CP858
  • 860,CP860,IBM860,CSIBM860
  • 861,CP-IS,CP861,IBM861,CSIBM861
  • 863,CP863,IBM863,CSIBM863
  • CP864,IBM864,CSIBM864
  • 865,CP865,IBM865,CSIBM865
  • 869,CP-GR,CP869,IBM869,CSIBM869
  • CP1125
  • EUC-JIS-2004,EUC-JISX0213
  • SHIFT_JIS-2004,SHIFT_JISX0213
  • ISO-2022-JP-2004,ISO-2022-JP-3
  • BIG5-2003
  • ISO-IR-230,TDS565
  • ATARI,ATARIST
  • RISCOS-LATIN1

See also Text.ConvertFromTextEncoding function.

Examples

Encode and decode to check:

HexDecode( MBS( "Text.ConvertToTextEncoding"; "Hello World äöü"; "UTF-8" ))

Example result: "Hello World äöü"

Convert to CP1252 and back:

MBS( "Text.DecodeFromHex"; MBS( "Text.ConvertToTextEncoding"; "Hello World äöü"; "CP1252" ); "Windows")

Example result: "Hello World äöü"

Convert to PC865 (Nordic):

MBS( "Text.ConvertToTextEncoding"; "Hello øØ"; "CP865" )

Example result: "48656C6C6F209B9D"

See also

Blog Entries

Release notes

Created 13th August 2019, last changed 13th August 2019


Text.ConvertFromTextEncoding   -   Text.ConvertUnicodeToCharacterComposition

Feedback: Report problem or ask question.




Links
MBS Xojo Plugins