Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3   11.4    Statistic    FMM    Blog  

Text.ConvertToTextEncoding

Converts text into a text encoding.

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

Parameters

Parameter Description Example
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.

This functionality needs libiconv. On macOS, iOS and Linux we try to load the library coming with the OS. If you use Windows or like to use a custom library, please use Plugin.LoadIconvLibrary function to load it before calling this function.
Without iconv library, only a minimum functionality is done by plugin directly to keep basic functionality working.

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

Release notes

Blog Entries

Videos

Created 13th August 2019, last changed 22nd January 2021


Text.ConvertFromTextEncoding - Text.ConvertUnicodeToCharacterComposition

Feedback: Report problem or ask question.




Links
MBS Xojo blog

Start Chat