-- Copyright 2007-2025 Mitchell. See LICENSE.
-- This is a DUMMY FILE used for making LuaDoc for built-in functions in the string table.

--- Extends Lua's `string` library to provide character set conversions.
-- @module string

--- Converts string *text* from encoding *old* to encoding *new* using GNU libiconv, returning
-- the string result.
-- Raises an error if the encoding conversion failed.
-- Valid encodings are [GNU libiconv's encodings][] and include:
--
-- - European: ASCII, ISO-8859-{1,2,3,4,5,7,9,10,13,14,15,16}, KOI8-R,
--	KOI8-U, KOI8-RU, CP{1250,1251,1252,1253,1254,1257}, CP{850,866,1131},
--	Mac{Roman,CentralEurope,Iceland,Croatian,Romania}, Mac{Cyrillic,Ukraine,Greek,Turkish},
--	Macintosh.
-- - Semitic: ISO-8859-{6,8}, CP{1255,1256}, CP862, Mac{Hebrew,Arabic}.
-- - Japanese: EUC-JP, SHIFT_JIS, CP932, ISO-2022-JP, ISO-2022-JP-2, ISO-2022-JP-1.
-- - Chinese: EUC-CN, HZ, GBK, CP936, GB18030, EUC-TW, BIG5, CP950, BIG5-HKSCS, BIG5-HKSCS:2004,
--	BIG5-HKSCS:2001, BIG5-HKSCS:1999, ISO-2022-CN, ISO-2022-CN-EXT.
-- - Korean: EUC-KR, CP949, ISO-2022-KR, JOHAB.
-- - Armenian: ARMSCII-8.
-- - Georgian: Georgian-Academy, Georgian-PS.
-- - Tajik: KOI8-T.
-- - Kazakh: PT154, RK1048.
-- - Thai: ISO-8859-11, TIS-620, CP874, MacThai.
-- - Laotian: MuleLao-1, CP1133.
-- - Vietnamese: VISCII, TCVN, CP1258.
-- - Unicode: UTF-8, UCS-2, UCS-2BE, UCS-2LE, UCS-4, UCS-4BE, UCS-4LE, UTF-16, UTF-16BE,
--	UTF-16LE, UTF-32, UTF-32BE, UTF-32LE, UTF-7, C99, JAVA.
--
-- [GNU libiconv's encodings]: https://www.gnu.org/software/libiconv/
-- @param text The text to convert.
-- @param new The string encoding to convert to.
-- @param old The string encoding to convert from.
-- @function iconv
