الاسم¶

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

المعايير¶

POSIX.1-2008.

التاريخ¶

glibc 2.1. POSIX.1-2001, SUSv2.

انظر أيضًا¶

iconv(1), iconv(3), iconv_close(3)

ترجمة¶

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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