inet_ntop(3)

الاسم
inet_ntop - تحويل عناوين IPv4 و IPv6 من الصيغة الثنائية إلى الصيغة النصية

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

موجز
#include <arpa/inet.h>

const char *inet_ntop(socklen_t size;
                      int af, const void *restrict src,
                      char dst[restrict size], socklen_t size);

الوصف
تحوّل هذه الدالة بنية عنوان الشبكة src في عائلة العناوين af إلى سلسلة محارف. تُنسخ السلسلة الناتجة إلى المخزن المؤقت المشار إليه بـ dst، والذي يجب أن يكون مؤشرًا غير فارغ. يُحدد المستدعي عدد البايتات المتاحة في هذا المخزن في المعامل size.

تمدّد inet_ntop() الدالة inet_ntoa(3) لدعم عائلات عناوين متعددة، وتُعتبر inet_ntoa(3) الآن مهملة لصالح inet_ntop(). عائلات العناوين التالية مدعومة حاليًا:

AF_INET
    يشير src إلى struct in_addr (بترتيب بايتات الشبكة) والذي يُحوّل إلى عنوان شبكة IPv4 في الصيغة العشرية المنقوطة، "ddd.ddd.ddd.ddd". يجب أن يكون المخزن dst بطول INET_ADDRSTRLEN بايت على الأقل.

AF_INET6
    يشير src إلى struct in6_addr (بترتيب بايتات الشبكة) والذي يُحوّل إلى تمثيل لهذا العنوان في أنسب صيغة عنوان شبكة IPv6 لهذا العنوان. يجب أن يكون المخزن dst بطول INET6_ADDRSTRLEN بايت على الأقل.

قيمة الإرجاع
عند النجاح، تُعيد inet_ntop() مؤشرًا غير فارغ إلى dst. يُعاد NULL إذا حدث خطأ، مع تعيين errno للإشارة إلى الخطأ.

الأخطاء

EAFNOSUPPORT
    لم تكن af عائلة عناوين صالحة.

ENOSPC
    ستتجاوز سلسلة العنوان المحوّلة الحجم المُعطى بواسطة size.

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

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

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

لاحظ أن RFC 2553 يُعرّف نموذجًا أوليًا حيث المعامل الأخير size من النوع size_t. تتبع العديد من الأنظمة RFC 2553. glibc 2.0 و 2.1 تحتوي على size_t، لكن 2.2 وما بعده تحتوي على socklen_t.

العلل
يحوّل AF_INET6 عناوين IPv6 المُعيّنة لـ IPv4 إلى صيغة IPv6.

أمثلة
انظر inet_pton(3).

انظر أيضًا
getnameinfo(3), inet(3), inet_pton(3)

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

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

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