iconv_open

ICONV_OPEN(3)   Ð ÑководÑÑво пÑогÑаммиÑÑа Linux   ICONV_OPEN(3)



ÐÐЯ
       iconv_open - ÑоздаÑÑ Ð´ÐµÑкÑипÑÐ¾Ñ Ð¿ÑеобÑазованиÑ
       кодиÑовки набоÑа Ñимволов

ÐÐÐÐÐ
       #include <iconv.h>

       iconv_t iconv_open(const char *tocode, const char *fromcode);

ÐÐÐСÐÐÐÐ
       ФÑнкÑÐ¸Ñ iconv_open() ÑоздаÑÑ Ð´ÐµÑкÑипÑоÑ,
       пÑедназнаÑеннÑй Ð´Ð»Ñ Ð¿ÑеобÑазованиÑ
       поÑледоваÑелÑноÑÑи байÑов Ñ ÐºÐ¾Ð´Ð¸Ñовкой
       fromcode в кодиÑÐ¾Ð²ÐºÑ tocode.

       ÐнаÑениÑ, допÑÑÑимÑе Ð´Ð»Ñ ÐºÐ¾Ð´Ð¸Ñовок fromcode и
       tocode, и поддеÑживаемÑе комбинаÑии, завиÑÑÑ
       Ð¾Ñ Ð¾Ð¿ÐµÑаÑионной ÑиÑÑемÑ. ÐÐ»Ñ Ð±Ð¸Ð±Ð»Ð¸Ð¾Ñеки GNU C
       ÑазÑеÑÑннÑе знаÑÐµÐ½Ð¸Ñ Ð²ÑводÑÑÑÑ Ð¿Ð¾ команде
       iconv --list, а Ñакже поддеÑживаÑÑÑÑ Ð²Ñе
       комбинаÑии пеÑеÑиÑленнÑÑ Ð·Ð½Ð°Ñений. ÐÑоме
       ÑÑого, библиоÑеки GNU C и GNU libiconv
       поддеÑживаÑÑ Ð´Ð²Ð° ÑледÑÑÑÐ¸Ñ ÑÑÑÑикÑа:

       //TRANSLIT
              ÐÑли к tocode добавлена ÑÑÑока «//TRANSLIT»,
              Ñо вклÑÑаеÑÑÑ ÑÑанÑлиÑеÑаÑиÑ. ÐÑо ознаÑаеÑ,
              ÑÑо когда Ñимвол не Ð¼Ð¾Ð¶ÐµÑ Ð±ÑÑÑ
              пÑедÑÑавлен в Ñелевом набоÑе
              Ñимволов, Ñо он аппÑокÑимиÑÑеÑÑÑ Ð¾Ð´Ð½Ð¸Ð¼
              или неÑколÑкими поÑожими Ñимволами.

       //IGNORE
              ÐÑли к tocode добавлена ÑÑÑока «//IGNORE», Ñо
              ÑимволÑ, коÑоÑÑе не могÑÑ Ð±ÑÑÑ
              пÑедÑÑÐ°Ð²Ð»ÐµÐ½Ñ Ð² Ñелевом набоÑе
              Ñимволов, бÑдÑÑ Ð¿ÑоÑÑо оÑбÑаÑÑваÑÑÑÑ.

       ÐолÑÑеннÑй деÑкÑипÑÐ¾Ñ Ð¿ÑеобÑÐ°Ð·Ð¾Ð²Ð°Ð½Ð¸Ñ Ð¼Ð¾Ð¶ÐµÑ
       иÑполÑзоваÑÑÑÑ ÑÑнкÑией iconv(3) лÑбое
       колиÑеÑÑво Ñаз. Ðн оÑÑаеÑÑÑ Ð½ÐµÐ¸Ð·Ð¼ÐµÐ½Ð½Ñм до ÑеÑ
       поÑ, пока не бÑÐ´ÐµÑ Ð¾ÑвобождÑн ÑÑнкÑией
       iconv_close(3).

       ÐеÑкÑипÑÐ¾Ñ Ð¿ÑеобÑÐ°Ð·Ð¾Ð²Ð°Ð½Ð¸Ñ ÑодеÑÐ¶Ð¸Ñ ÑоÑÑоÑние
       пеÑекодиÑовки ÐоÑле ÑÐ¾Ð·Ð´Ð°Ð½Ð¸Ñ Ñ Ð¿Ð¾Ð¼Ð¾ÑÑÑ
       ÑÑнкÑии iconv_open(), ÑоÑÑоÑние Ñавно наÑалÑномÑ
       знаÑениÑ. ÐÑполÑзование iconv(3) менÑеÑ
       ÑоÑÑоÑние пÑеобÑазованиÑ. ЧÑÐ¾Ð±Ñ Ð²ÐµÑнÑÑÑ
       ÑоÑÑоÑние в наÑалÑное знаÑение, необÑодимо
       иÑполÑзоваÑÑ ÑÑнкÑÐ¸Ñ iconv(3) Ñ Ð¿Ð°ÑамеÑÑом inbuf,
       ÑавнÑм NULL.

ÐÐÐÐÐ ÐЩÐÐÐÐÐ ÐÐÐЧÐÐÐÐ
       ÐÑи ÑÑпеÑном вÑполнении ÑÑнкÑÐ¸Ñ iconv_open()
       возвÑаÑÐ°ÐµÑ ÑозданнÑй деÑкÑипÑоÑ
       пÑеобÑазованиÑ. Ð ÑлÑÑае оÑибки менÑеÑÑÑ
       знаÑение пеÑеменной errno и возвÑаÑаеÑÑÑ
       (iconv_t) -1.

ÐШÐÐÐÐ
       СÑеди пÑоÑиÑ, Ð¼Ð¾Ð¶ÐµÑ Ð²Ð¾Ð·Ð½Ð¸ÐºÐ½ÑÑÑ ÑледÑÑÑаÑ
       оÑибка:

       EINVAL ÐÑеобÑазование из кодиÑовки fromcode в
              tocode не поддеÑживаеÑÑÑ Ð² данной
              ÑеализаÑии.

ÐÐРСÐÐ
       ÐÑа ÑÑнкÑÐ¸Ñ Ð´Ð¾ÑÑÑпна в glibc наÑÐ¸Ð½Ð°Ñ Ñ Ð²ÐµÑÑии 2.1.

ÐТРÐÐУТЫ
       ÐпиÑание ÑеÑминов данного Ñаздела ÑмоÑÑиÑе
       в attributes(7).

       ┌──────────────┬────────────────────────────────┬────────────────┐
       │ÐнÑеÑÑÐµÐ¹Ñ ÐÑÑибÑÑ                      ÐнаÑение │
       ├──────────────┼────────────────────────────────┼────────────────┤
       │iconv_open()  │ ÐезвÑедноÑÑÑ Ð² ниÑÑÑ │ MT-Safe locale │
       └──────────────┴────────────────────────────────┴────────────────┘

СÐÐТÐÐТСТÐÐРСТÐÐÐÐРТÐÐ
       POSIX.1-2001, POSIX.1-2008, SUSv2.

СÐÐТРÐТРТÐÐÐÐ
       iconv(1), iconv(3), iconv_close(3)



GNU                               2015-08-08                     ICONV_OPEN(3)