.\" -*- coding: UTF-8 -*- '\" t .\" Copyright, Bruno Haible .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH iconv_open 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم iconv_open \- تخصيص واصف لتحويل مجموعة المحارف .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBiconv_t iconv_open(const char *\fP\fItocode\fP\fB, const char *\fP\fIfromcode\fP\fB);\fP .fi .SH الوصف تخصص دالة \fBiconv_open\fP() واصف تحويل مناسب لتحويل تسلسلات البايت من ترميز المحارف \fIfromcode\fP إلى ترميز المحارف \fItocode\fP. .P القيم المسموح بها لـ \fIfromcode\fP و \fItocode\fP والتوليفات المدعومة تعتمد على النظام. بالنسبة لمكتبة GNU C، تُدرج القيم المسموح بها بواسطة أمر \fIiconv \-\-list\fP، وتُدعم جميع توليفات القيم المدرجة. علاوة على ذلك، تدعم مكتبة GNU C ومكتبة GNU libiconv اللاحقتين التاليتين: .TP //TRANSLIT عند إلحاق السلسلة "//TRANSLIT" بـ \fItocode\fP، تُفعّل النقحرة. يعني هذا أنه عندما لا يمكن تمثيل محرف في مجموعة المحارف الهدفية، يمكن تقريبه من خلال محرف واحد أو عدة محارف متشابهة المظهر. .TP //IGNORE عند إلحاق السلسلة "//IGNORE" بـ \fItocode\fP، تُتجاهل المحارف التي لا يمكن تمثيلها في مجموعة المحارف الهدفية بصمت. .P يمكن استخدام واصف التحويل الناتج مع \fBiconv\fP(3) أي عدد من المرات. يبقى صالحًا حتى يُحرر باستخدام \fBiconv_close\fP(3). .P يحتوي واصف التحويل على حالة تحويل. بعد الإنشاء باستخدام \fBiconv_open\fP()، تكون الحالة في الحالة الابتدائية. يُعدّل استخدام \fBiconv\fP(3) حالة تحويل الواصف. لإعادة الحالة إلى الحالة الابتدائية، استخدم \fBiconv\fP(3) مع NULL كوسيط \fIinbuf\fP. .SH "قيمة الإرجاع" عند النجاح، تُرجع \fBiconv_open\fP() واصف تحويل مُخصص حديثًا. عند الفشل، تُرجع \fI(iconv_t)\ \-1\fP وتضبط \fIerrno\fP للإشارة إلى الخطأ. .SH الأخطاء يمكن أن يحدث الخطأ التالي، من بين أخطاء أخرى: .TP \fBEINVAL\fP التحويل من \fIfromcode\fP إلى \fItocode\fP غير مدعوم من قبل التنفيذ. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBiconv_open\fP() T} سلامة الخيوط المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe) .TE .SH المعايير POSIX.1\-2008. .SH التاريخ glibc 2.1. POSIX.1\-2001, SUSv2. .SH "انظر أيضًا" \fBiconv\fP(1), \fBiconv\fP(3), \fBiconv_close\fP(3) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .