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: 11.2   11.3   11.4   11.5   12.0   12.1   12.2   12.3   12.4   12.5    Statistic    FMM    Blog  

Text.ConvertFromTextEncoding

Converts text from a text encoding.

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

Parameters

Parameter Description Example
Text The hex encoded text to convert. "48656C6C6F209B9D"
Encoding The source encoding.
Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ.
"CP465"

Result

Returns text or error.

Description

Converts text from a text encoding.
Returns text in unicode as FileMaker needs it.
As we use iconv library here, we can handle many more encodings than the standard FileMaker text functions used within the plugin.

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.ConvertToTextEncoding 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.

This function works on pure text, so any text style is lost.

Examples

Convert from nordic:

MBS( "Text.ConvertFromTextEncoding"; "48656C6C6F209B9D"; "CP865" )

Example result: "Hello øØ"

See also

Release notes

Blog Entries

Created 13th August 2019, last changed 28th January 2022


Text.Concat - Text.ConvertToTextEncoding

Feedback: Report problem or ask question.


Start Chat