recode()

The function converts a string and returns the string in the desired encoding.

Synopsis

string recode(string s, string sourceEncoding, [string targetEncoding]);

Parameters

Parameter Meaning
s A string that is converted.
sourceEncoding The source encoding.
targetEncoding The target encoding. The target encoding. The default target encoding is the project encoding.

Return value

The converted string.

Description

The function converts a string and returns the string in the desired encoding.

As of the version 3.19 ISO projects cannot be created anymore. Create UTF-8 projects instead.

Possible Encodings

  • ISO-8859-1
  • latin1
  • CP819
  • IBM819
  • iso-ir-100
  • csISOLatin1
  • UTF-8
  • windows-1252
  • ibm-5348_P100-1997
  • ibm-5348
  • cp1252
  • UTF-8
  • ibm-1208
  • ibm-1209
  • ibm-5304
  • ibm-5305
  • ibm-13496
  • ibm-13497
  • ibm-17592
  • ibm-17593
  • windows-65001
  • cp1208
  • x-UTF_8J
  • unicode-1-1-utf-8
  • unicode-2-0-utf-8
  • UTF-16
  • ISO-10646-UCS-2
  • ibm-1204
  • ibm-1205
  • unicode
  • csUnicode
  • ucs-2
  • UTF-16BE
  • x-utf-16be
  • UnicodeBigUnmarked
  • ibm-1200
  • ibm-1201
  • ibm-13488
  • ibm-13489
  • ibm-17584
  • ibm-17585
  • ibm-21680
  • ibm-21681
  • ibm-25776
  • ibm-25777
  • ibm-29872
  • ibm-29873
  • ibm-61955
  • ibm-61956
  • windows-1201
  • cp1200
  • cp1201
  • UTF16_BigEndian
  • UTF-16LE
  • x-utf-16le
  • UnicodeLittleUnmarked
  • ibm-1202
  • ibm-1203
  • ibm-13490
  • ibm-13491
  • ibm-17586
  • ibm-17587
  • ibm-21682
  • ibm-21683
  • ibm-25778
  • ibm-25779
  • ibm-29874
  • ibm-29875
  • UTF16_LittleEndian
  • windows-1200
  • UTF-32
  • ISO-10646-UCS-4
  • ibm-1236
  • ibm-1237
  • csUCS4
  • ucs-4
  • UTF-32BE
  • UTF32_BigEndian
  • ibm-1232
  • ibm-1233
  • ibm-9424
  • UTF-32LE
  • UTF32_LittleEndian
  • ibm-1234
  • ibm-1235
  • UTF-7
  • windows-65000
  • unicode-1-1-utf-7
  • unicode-2-0-utf-7
  • SCSU
  • ibm-1212
  • ibm-1213
  • BOCU-1
  • csBOCU-1
  • ibm-1214
  • ibm-1215
  • CESU-8
  • ibm-9400
  • ISO-8859-1
  • ibm-819
  • IBM819
  • cp819
  • latin1
  • 8859_1
  • csISOLatin1
  • iso-ir-100
  • ISO_8859-1:1987
  • l1
  • 819
  • US-ASCII
  • ASCII
  • ANSI_X3.4-1968
  • ANSI_X3.4-1986
  • ISO_646.irv:1991
  • iso_646.irv:1983
  • ISO646-US
  • us
  • csASCII
  • iso-ir-6
  • cp367
  • ascii7
  • 646
  • windows-20127
  • ibm-367
  • IBM367
  • gb18030
  • ibm-1392
  • windows-54936
  • GB18030
  • ibm-912_P100-1995
  • ibm-912
  • ISO-8859-2
  • ISO_8859-2:1987
  • latin2
  • csISOLatin2
  • iso-ir-101
  • l2
  • 8859_2
  • cp912
  • 912
  • windows-28592
  • ibm-913_P100-2000
  • ibm-913
  • ISO-8859-3
  • ISO_8859-3:1988
  • latin3
  • csISOLatin3
  • iso-ir-109
  • l3
  • 8859_3
  • cp913
  • 913
  • windows-28593
  • ibm-914_P100-1995
  • ibm-914
  • ISO-8859-4
  • latin4
  • csISOLatin4
  • iso-ir-110
  • ISO_8859-4:1988
  • l4
  • 8859_4
  • cp914
  • 914
  • windows-28594
  • ibm-915_P100-1995
  • ibm-915
  • ISO-8859-5
  • cyrillic
  • csISOLatinCyrillic
  • iso-ir-144
  • ISO_8859-5:1988
  • 8859_5
  • cp915
  • 915
  • windows-28595
  • ibm-1089_P100-1995
  • ibm-1089
  • ISO-8859-6
  • arabic
  • csISOLatinArabic
  • iso-ir-127
  • ISO_8859-6:1987
  • ECMA-114
  • ASMO-708
  • 8859_6
  • cp1089
  • 1089
  • windows-28596
  • ISO-8859-6-I
  • ISO-8859-6-E
  • x-ISO-8859-6S
  • ibm-9005_X110-2007
  • ibm-9005
  • ISO-8859-7
  • 8859_7
  • greek
  • greek8
  • ELOT_928
  • ECMA-118
  • csISOLatinGreek
  • iso-ir-126
  • ISO_8859-7:1987
  • windows-28597
  • sun_eu_greek
  • ibm-5012_P100-1999
  • ibm-5012
  • ISO-8859-8
  • hebrew
  • csISOLatinHebrew
  • iso-ir-138
  • ISO_8859-8:1988
  • ISO-8859-8-I
  • ISO-8859-8-E
  • 8859_8
  • windows-28598
  • hebrew8
  • ibm-920_P100-1995
  • ibm-920
  • ISO-8859-9
  • latin5
  • csISOLatin5
  • iso-ir-148
  • ISO_8859-9:1989
  • l5
  • 8859_9
  • cp920
  • 920
  • windows-28599
  • ECMA-128
  • turkish8
  • turkish
  • iso-8859_10-1998
  • ISO-8859-10
  • iso-ir-157
  • l6
  • ISO_8859-10:1992
  • csISOLatin6
  • latin6
  • ibm-921_P100-1995
  • ibm-921
  • ISO-8859-13
  • 8859_13
  • windows-28603
  • cp921
  • 921
  • x-IBM921
  • iso-8859_14-1998
  • ISO-8859-14
  • iso-ir-199
  • ISO_8859-14:1998
  • latin8
  • iso-celtic
  • l8
  • ibm-923_P100-1998
  • ibm-923
  • ISO-8859-15
  • Latin-9
  • l9
  • 8859_15
  • latin0
  • csisolatin0
  • csisolatin9
  • iso8859_15_fdis
  • cp923
  • 923
  • windows-28605
  • ibm-943_P15A-2003
  • ibm-943
  • Shift_JIS
  • MS_Kanji
  • csShiftJIS
  • windows-31j
  • csWindows31J
  • x-sjis
  • x-ms-cp932
  • cp932
  • windows-932
  • cp943c
  • IBM-943C
  • ms932
  • pck
  • sjis
  • ibm-943_VSUB_VPUA
  • x-MS932_0213
  • x-JISAutoDetect
  • euc-jp-2007
  • EUC-JP
  • Extended_UNIX_Code_Packed_Format_for_Japanese
  • csEUCPkdFmtJapanese
  • X-EUC-JP
  • eucjis
  • ujis
  • windows-950-2000
  • Big5
  • csBig5
  • windows-950
  • x-windows-950
  • x-big5
  • ms950
  • ibm-1375_P100-2007
  • ibm-1375
  • Big5-HKSCS
  • big5hk
  • HKSCS-BIG5
  • windows-936-2000
  • GBK
  • CP936
  • MS936
  • windows-936
  • ibm-1383_P110-1999
  • ibm-1383
  • GB2312
  • csGB2312
  • cp1383
  • 1383
  • EUC-CN
  • ibm-eucCN
  • hp15CN
  • ibm-1383_VPUA
  • ibm-5478_P100-1995
  • ibm-5478
  • GB_2312-80
  • chinese
  • iso-ir-58
  • csISO58GB231280
  • gb2312-1980
  • GB2312.1980-0
  • ibm-970_P110_P110-2006_U2
  • ibm-970
  • EUC-KR
  • KS_C_5601-1987
  • windows-51949
  • csEUCKR
  • ibm-eucKR
  • KSC_5601
  • 5601
  • cp970
  • 970
  • ibm-970_VPUA
  • x-IBM970
  • ibm-1363_P11B-1998
  • ibm-1363
  • KS_C_5601-1987
  • KS_C_5601-1989
  • KSC_5601
  • csKSC56011987
  • korean
  • iso-ir-149
  • cp1363
  • 5601
  • ksc
  • windows-949
  • ibm-1363_VSUB_VPUA
  • x-IBM1363C
  • windows-949-2000
  • windows-949
  • KS_C_5601-1987
  • KS_C_5601-1989
  • KSC_5601
  • csKSC56011987
  • korean
  • iso-ir-149
  • ms949
  • x-KSC5601
  • windows-874-2000
  • TIS-620
  • windows-874
  • MS874
  • x-windows-874
  • ibm-437_P100-1995
  • ibm-437
  • IBM437
  • cp437
  • 437
  • csPC8CodePage437
  • windows-437
  • ibm-775_P100-1996
  • ibm-775
  • IBM775
  • cp775
  • csPC775Baltic
  • windows-775
  • 775
  • ibm-850_P100-1995
  • ibm-850
  • IBM850
  • cp850
  • 850
  • csPC850Multilingual
  • windows-850
  • ibm-851_P100-1995
  • ibm-851
  • IBM851
  • cp851
  • 851
  • csPC851
  • ibm-852_P100-1995
  • ibm-852
  • IBM852
  • cp852
  • 852
  • csPCp852
  • windows-852
  • ibm-855_P100-1995
  • ibm-855
  • IBM855
  • cp855
  • 855
  • csIBM855
  • csPCp855
  • windows-855
  • ibm-857_P100-1995
  • ibm-857
  • IBM857
  • cp857
  • 857
  • csIBM857
  • windows-857
  • ibm-858_P100-1997
  • ibm-858
  • IBM00858
  • CCSID00858
  • CP00858
  • PC-Multilingual-850+euro
  • cp858
  • windows-858
  • ibm-860_P100-1995
  • ibm-860
  • IBM860
  • cp860
  • 860
  • csIBM860
  • ibm-861_P100-1995
  • ibm-861
  • IBM861
  • cp861
  • 861
  • cp-is
  • csIBM861
  • windows-861
  • ibm-862_P100-1995
  • ibm-862
  • IBM862
  • cp862
  • 862
  • csPC862LatinHebrew
  • DOS-862
  • windows-862
  • ibm-863_P100-1995
  • ibm-863
  • IBM863
  • cp863
  • 863
  • csIBM863
  • ibm-864_X110-1999
  • ibm-864
  • IBM864
  • cp864
  • csIBM864
  • ibm-865_P100-1995
  • ibm-865
  • IBM865
  • cp865
  • 865
  • csIBM865
  • ibm-866_P100-1995
  • ibm-866
  • IBM866
  • cp866
  • 866
  • csIBM866
  • windows-866
  • ibm-868_P100-1995
  • ibm-868
  • IBM868
  • CP868
  • 868
  • csIBM868
  • cp-ar
  • ibm-869_P100-1995
  • ibm-869
  • IBM869
  • cp869
  • 869
  • cp-gr
  • csIBM869
  • windows-869
  • ibm-878_P100-1996
  • ibm-878
  • KOI8-R
  • koi8
  • csKOI8R
  • windows-20866
  • cp878
  • ibm-1168_P100-2002
  • ibm-1168
  • KOI8-U
  • windows-21866
  • ibm-5346_P100-1998
  • ibm-5346
  • windows-1250
  • cp1250
  • ibm-5347_P100-1998
  • ibm-5347
  • windows-1251
  • cp1251
  • ANSI1251
  • ibm-5348_P100-1997
  • ibm-5348
  • windows-1252
  • cp1252
  • ibm-5349_P100-1998
  • ibm-5349
  • windows-1253
  • cp1253
  • ibm-5350_P100-1998
  • ibm-5350
  • windows-1254
  • cp1254
  • ibm-9447_P100-2002
  • ibm-9447
  • windows-1255
  • cp1255
  • ibm-9448_X100-2005
  • ibm-9448
  • windows-1256
  • cp1256
  • x-windows-1256S
  • ibm-9449_P100-2002
  • ibm-9449
  • windows-1257
  • cp1257
  • ibm-5354_P100-1998
  • ibm-5354
  • windows-1258
  • cp1258
  • macos-0_2-10.2
  • macintosh
  • mac
  • csMacintosh
  • windows-10000
  • macroman
  • x-macroman
  • macos-6_2-10.4
  • x-mac-greek
  • windows-10006
  • macgr
  • x-MacGreek
  • macos-7_3-10.2
  • x-mac-cyrillic
  • windows-10007
  • mac-cyrillic
  • maccy
  • x-MacCyrillic
  • x-MacUkraine
  • macos-29-10.2
  • x-mac-centraleurroman
  • windows-10029
  • x-mac-ce
  • macce
  • maccentraleurope
  • x-MacCentralEurope
  • macos-35-10.2
  • x-mac-turkish
  • windows-10081
  • mactr
  • x-MacTurkish
  • ibm-1051_P100-1995
  • ibm-1051
  • hp-roman8
  • roman8
  • r8
  • csHPRoman8
  • x-roman8
  • ibm-1276_P100-1995
  • ibm-1276
  • Adobe-Standard-Encoding
  • csAdobeStandardEncoding
  • ISO_2022
  • locale=ja
  • version=0
  • ISO-2022-JP
  • csISO2022JP
  • x-windows-iso2022jp
  • x-windows-50220
  • ISO_2022
  • locale=ja
  • version=1
  • ISO-2022-JP-1
  • JIS_Encoding
  • csJISEncoding
  • ibm-5054
  • JIS
  • x-windows-50221
  • ISO_2022
  • locale=ja
  • version=2
  • ISO-2022-JP-2
  • csISO2022JP2
  • ISO_2022
  • locale=ko
  • version=0
  • ISO-2022-KR
  • csISO2022KR
  • ISO_2022
  • locale=zh
  • version=0
  • ISO-2022-CN
  • csISO2022CN
  • x-ISO-2022-CN-GB
  • ISO_2022
  • locale=zh
  • version=1
  • ISO-2022-CN-EXT
  • HZ
  • HZ-GB-2312
  • ibm-37_P100-1995
  • ibm-37
  • IBM037
  • ibm-037
  • ebcdic-cp-us
  • ebcdic-cp-ca
  • ebcdic-cp-wt
  • ebcdic-cp-nl
  • csIBM037
  • cp037
  • 037
  • cpibm37
  • cp37
  • ibm-273_P100-1995
  • ibm-273
  • IBM273
  • CP273
  • csIBM273
  • ebcdic-de
  • 273
  • ibm-277_P100-1995
  • ibm-277
  • IBM277
  • cp277
  • EBCDIC-CP-DK
  • EBCDIC-CP-NO
  • csIBM277
  • ebcdic-dk
  • 277
  • ibm-278_P100-1995
  • ibm-278
  • IBM278
  • cp278
  • ebcdic-cp-fi
  • ebcdic-cp-se
  • csIBM278
  • ebcdic-sv
  • 278
  • ibm-280_P100-1995
  • ibm-280
  • IBM280
  • CP280
  • ebcdic-cp-it
  • csIBM280
  • 280
  • ibm-284_P100-1995
  • ibm-284
  • IBM284
  • CP284
  • ebcdic-cp-es
  • csIBM284
  • cpibm284
  • 284
  • ibm-285_P100-1995
  • ibm-285
  • IBM285
  • CP285
  • ebcdic-cp-gb
  • csIBM285
  • cpibm285
  • ebcdic-gb
  • 285
  • ibm-290_P100-1995
  • ibm-290
  • IBM290
  • cp290
  • EBCDIC-JP-kana
  • csIBM290
  • ibm-297_P100-1995
  • ibm-297
  • IBM297
  • cp297
  • ebcdic-cp-fr
  • csIBM297
  • cpibm297
  • 297
  • ibm-420_X120-1999
  • ibm-420
  • IBM420
  • cp420
  • ebcdic-cp-ar1
  • csIBM420
  • 420
  • ibm-424_P100-1995
  • ibm-424
  • IBM424
  • cp424
  • ebcdic-cp-he
  • csIBM424
  • 424
  • ibm-500_P100-1995
  • ibm-500
  • IBM500
  • CP500
  • ebcdic-cp-be
  • csIBM500
  • ebcdic-cp-ch
  • 500
  • ibm-838_P100-1995
  • ibm-838
  • IBM838
  • IBM-Thai
  • csIBMThai
  • cp838
  • 838
  • ibm-9030
  • ibm-870_P100-1995
  • ibm-870
  • IBM870
  • CP870
  • ebcdic-cp-roece
  • ebcdic-cp-yu
  • csIBM870
  • ibm-871_P100-1995
  • ibm-871
  • IBM871
  • ebcdic-cp-is
  • csIBM871
  • CP871
  • ebcdic-is
  • 871
  • ibm-918_P100-1995
  • ibm-918
  • IBM918
  • CP918
  • ebcdic-cp-ar2
  • csIBM918
  • ibm-1026_P100-1995
  • ibm-1026
  • IBM1026
  • CP1026
  • csIBM1026
  • 1026
  • ibm-1047_P100-1995
  • ibm-1047
  • IBM1047
  • cp1047
  • 1047
  • ibm-1140_P100-1997
  • ibm-1140
  • IBM01140
  • CCSID01140
  • CP01140
  • cp1140
  • ebcdic-us-37+euro
  • ibm-1141_P100-1997
  • ibm-1141
  • IBM01141
  • CCSID01141
  • CP01141
  • cp1141
  • ebcdic-de-273+euro
  • ibm-1142_P100-1997
  • ibm-1142
  • IBM01142
  • CCSID01142
  • CP01142
  • cp1142
  • ebcdic-dk-277+euro
  • ebcdic-no-277+euro
  • ibm-1143_P100-1997
  • ibm-1143
  • IBM01143
  • CCSID01143
  • CP01143
  • cp1143
  • ebcdic-fi-278+euro
  • ebcdic-se-278+euro
  • ibm-1144_P100-1997
  • ibm-1144
  • IBM01144
  • CCSID01144
  • CP01144
  • cp1144
  • ebcdic-it-280+euro
  • ibm-1145_P100-1997
  • ibm-1145
  • IBM01145
  • CCSID01145
  • CP01145
  • cp1145
  • ebcdic-es-284+euro
  • ibm-1146_P100-1997
  • ibm-1146
  • IBM01146
  • CCSID01146
  • CP01146
  • cp1146
  • ebcdic-gb-285+euro
  • ibm-1147_P100-1997
  • ibm-1147
  • IBM01147
  • CCSID01147
  • CP01147
  • cp1147
  • ebcdic-fr-297+euro
  • ibm-1148_P100-1997
  • ibm-1148
  • IBM01148
  • CCSID01148
  • CP01148
  • cp1148
  • ebcdic-international-500+euro
  • ibm-1149_P100-1997
  • ibm-1149
  • IBM01149
  • CCSID01149
  • CP01149
  • cp1149
  • ebcdic-is-871+euro
  • TSCII
main()
{
  string templateFile;

/* An ISO file - fileToString().
    Writes the content of the ISO file to a string */
  bool ret = fileToString("D:\\Documents\\recodeISO.txt", templateFile, "ISO88591");
  DebugN("fileToString() return ", ret);
  dyn_string templateConfigs = strsplit(templateFile, '\n');
  DebugN("An ISO file to String",templateConfigs);


//ISO file - recode() function.
    Converts an ISO file to a UTF8 file
  bool ret2 = fileToString("D:\\Documents\\recodeISO.txt", templateFile);
  DebugN("fileToString() return ", ret2);
  templateFile = recode(templateFile, "ISO88591", "UTF8");
  dyn_string templateConfigs = strsplit(templateFile, '\n');
  DebugN("An ISO String to UTF",templateConfigs);
}

Assignment

File function

Availability

UI