wcpncpy(3)

الاسم
wcpncpy - نسخ سلسلة محارف عريضة بحجم ثابت، مع إرجاع مؤشر إلى نهايتها

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

موجز
#include <wchar.h>

wchar_t *wcpncpy(size_t n;
                 wchar_t dest[restrict n],
                 const wchar_t *restrict src,
                 size_t n);

    متطلبات ماكروات اختبار الميزات لـ glibc (انظر feature_test_macros(7)):

wcpncpy():
    منذ glibc 2.10:
        _POSIX_C_SOURCE >= 200809L
    قبل glibc 2.10:
        _GNU_SOURCE

الوصف
الدالة wcpncpy() هي المكافئ للمحارف العريضة للدالة stpncpy(3). تنسخ على الأكثر n محرفًا عريضًا من سلسلة المحارف العريضة المشار إليها بواسطة src، بما في ذلك المحرف العريض الختامي الصفري (L'\0')، إلى المصفوفة المشار إليها بواسطة dest. يُكتب بالضبط n محرفًا عريضًا عند dest. إذا كان الطول wcslen(src) أصغر من n، فتُملأ المحارف العريضة المتبقية في المصفوفة المشار إليها بواسطة dest بمحارف L'\0'. إذا كان الطول wcslen(src) أكبر من أو يساوي n، فلن تُختتم السلسلة المشار إليها بواسطة dest بـ L'\0'.

يجب ألا تتداخل السلاسل النصية.

يجب على المبرمج التأكد من وجود مساحة لـ n من المحارف العريضة على الأقل في dest.

قيمة الإرجاع
تُرجع wcpncpy() مؤشرًا إلى ما بعد آخر محرف عريض غير صفري كُتب، أي dest + wcsnlen(src, n).

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

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

انظر أيضًا
stpncpy(3), wcsncpy(3)

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

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

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