iconv_open(3)

الاسم
iconv_open - تخصيص واصف لتحويل مجموعة المحارف

المكتبة
مكتبة سي المعيارية (libc، -lc)

موجز
#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
    عند إلحاق السلسلة "//TRANSLIT" بـ tocode، تُفعّل النقحرة. يعني هذا أنه عندما لا يمكن تمثيل محرف في مجموعة المحارف الهدفية، يمكن تقريبه من خلال محرف واحد أو عدة محارف متشابهة المظهر.

//IGNORE
    عند إلحاق السلسلة "//IGNORE" بـ tocode، تُتجاهل المحارف التي لا يمكن تمثيلها في مجموعة المحارف الهدفية بصمت.

يمكن استخدام واصف التحويل الناتج مع iconv(3) أي عدد من المرات. يبقى صالحًا حتى يُحرر باستخدام iconv_close(3).

يحتوي واصف التحويل على حالة تحويل. بعد الإنشاء باستخدام iconv_open()، تكون الحالة في الحالة الابتدائية. يُعدّل استخدام iconv(3) حالة تحويل الواصف. لإعادة الحالة إلى الحالة الابتدائية، استخدم iconv(3) مع NULL كوسيط inbuf.

قيمة الإرجاع
عند النجاح، تُرجع iconv_open() واصف تحويل مُخصص حديثًا. عند الفشل، تُرجع (iconv_t) -1 وتضبط errno للإشارة إلى الخطأ.

الأخطاء
يمكن أن يحدث الخطأ التالي، من بين أخطاء أخرى:

EINVAL
    التحويل من fromcode إلى tocode غير مدعوم من قبل التنفيذ.

السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر attributes(7).
الواجهة | السمة | القيمة
iconv_open() | سلامة الخيوط | المنطقة (locale) آمنة لتعدد المسالك (MT-Safe)

المعايير
POSIX.1-2008.

التاريخ
glibc 2.1. POSIX.1-2001, SUSv2.

انظر أيضًا
iconv(1), iconv(3), iconv_close(3)

ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.