iconv(1)

الاسم
iconv - تحويل النص من ترميز أحرف إلى آخر

موجز
iconv [options] [-f from-encoding] [-t to-encoding] [inputfile ...]

الوصف
يقرأ برنامج iconv النص بترميز واحد ويخرج النص بترميز آخر. إذا لم تُعطَ ملفات إدخال، أو إذا أُعطيت كشرطة (-)، يقرأ iconv من الإدخال المعياري. إذا لم يُعطَ ملف إخراج، يكتب iconv إلى الإخراج المعياري.

إذا لم يُعطَ من-ترميز، يُشتق المبدئي من ترميز الأحرف للإعدادات المحلية الحالية. إذا لم يُعطَ إلى-ترميز، يُشتق المبدئي من ترميز الأحرف للإعدادات المحلية الحالية.

الخيارات

--from-code=من-ترميز
-f from-encoding
    استخدم من-ترميز لأحرف الإدخال.

--to-code=إلى-ترميز
-t to-encoding
    استخدم إلى-ترميز لأحرف الإخراج.

    إذا أُلحقت السلسلة //IGNORE بـ إلى-ترميز، تُتجاهل الأحرف التي لا يمكن تحويلها ويُطبع خطأ بعد التحويل. (تُعالج الأحرف التي لا يمكن فك ترميزها كخطأ مع أو بدون هذه العلامة.)

    إذا أُلحقت السلسلة //TRANSLIT بـ إلى-ترميز، تُنقل أحرف التحويل صوتياً عند الحاجة والإمكان. يعني هذا أنه عندما لا يمكن تمثيل حرف في مجموعة الأحرف الهدف، يمكن تقريبه من خلال حرف أو عدة أحرف متشابهة. تُستبدل الأحرف خارج مجموعة الأحرف الهدف والتي لا يمكن نقلها صوتياً بعلامة استفهام (?) في الإخراج.

--list
-l
    اسرد جميع ترميزات مجموعات الأحرف المعروفة.

-c  تجاهل الأحرف التي لا يمكن تحويلها بدلاً من الإنهاء عند مواجهة هذه الأحرف. تتطلب POSIX ألا يغير هذا الخيار حالة خروج البرنامج.

--output=ملف_المخرج
-o outputfile
    استخدم ملف-مخرج للإخراج.

--silent
-s
    يُتجاهل هذا الخيار؛ يُقدم فقط للتوافق.

--verbose
    اطبع معلومات التقدم على الخطأ المعياري عند معالجة ملفات متعددة.

--help
-?
    يطبع ملخص الاستخدام ويخرج.

--usage
    اطبع ملخص استخدام قصير ثم اخرج.

--version
-V
    اطبع رقم الإصدار والترخيص وإخلاء المسؤولية عن الضمان لـ iconv.

حالة الخروج
صفر عند النجاح، وغير ذلك عند حدوث أخطاء.

البيئة
داخلياً، يستخدم برنامج iconv دالة iconv(3) التي تستخدم بدورها وحدات gconv (مكتبات مشتركة محملة ديناميكياً) للتحويل من وإلى مجموعة أحرف. قبل استدعاء iconv(3)، يجب على برنامج iconv أولاً تخصيص واصف تحويل باستخدام iconv_open(3). يتأثر تشغيل الدالة الأخيرة بإعداد متغير البيئة GCONV_PATH:

•   إذا لم يُضبط GCONV_PATH، يُحمّل iconv_open(3) ملف خبيئة تهيئة وحدة gconv النظامية الذي أنشأه iconvconfig(8) ثم، بناءً على التهيئة، يُحمّل وحدات gconv اللازمة لأداء التحويل. إذا لم يكن ملف خبيئة تهيئة وحدة gconv النظامية متاحاً، يُستخدم ملف تهيئة وحدة gconv النظامية.

•   إذا عُرّف GCONV_PATH (كقائمة من مسارات مفصولة بنقطتين)، لا تُستخدم خبيئة تهيئة وحدة gconv النظامية. بدلاً من ذلك، يحاول iconv_open(3) أولاً تحميل ملفات التهيئة بالبحث في الدلائل في GCONV_PATH بالترتيب، متبوعاً بملف تهيئة وحدة gconv المبدئي النظامي. إذا لم يحتوي دليل على ملف تهيئة وحدة gconv، تُتجاهل أي وحدات gconv قد يحتويها. إذا احتوى دليل على ملف تهيئة وحدة gconv وتقرر أن وحدة مطلوبة لهذا التحويل متاحة في الدليل، تُحمّل الوحدة المطلوبة من ذلك الدليل، بحيث يُستخدم أول وحدة مناسبة موجودة في GCONV_PATH. يسمح هذا للمستخدمين باستخدام وحدات مخصصة وحتى استبدال الوحدات المقدمة من النظام بتوفير هذه الوحدات في دلائل GCONV_PATH.

الملفات

/usr/lib/gconv
    مسار وحدة gconv المبدئي المعتاد.

/usr/lib/gconv/gconv-modules
    ملف إعداد وحدة gconv المبدئي المعتاد للنظام.

/usr/lib/gconv/gconv-modules.cache
    ذاكرة التخزين المؤقت المعتادة لإعدادات وحدة gconv للنظام.

اعتماداً على المعمارية، قد تقع الملفات المذكورة أعلاه بدلاً من ذلك في أدلة تبدأ بالمسار /usr/lib64.

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

التاريخ
POSIX.1-2001.

أمثلة
حوّل النص من ترميز الأحرف ISO/IEC 8859-15 إلى UTF-8:

    $ iconv -f ISO-8859-15 -t UTF-8 < input.txt > output.txt;

يحول المثال التالي من UTF-8 إلى ASCII، مع النقل الصوتي عند الإمكان:

    $ echo abc ß α € àḃç | iconv -f UTF-8 -t ASCII//TRANSLIT;
    abc ss ? EUR abc

انظر أيضًا
locale(1), uconv(1), iconv(3), nl_langinfo(3), charsets(7), iconvconfig(8)

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

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

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