.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright, Bruno Haible <bruno@clisp.org>
.\" 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 wcstok 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
wcstok \- تقسيم سلسلة محارف عريضة إلى رموز
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <wchar.h>\fP
.P
\fBwchar_t *wcstok(wchar_t *restrict \fP\fIwcs\fP\fB, const wchar_t *restrict \fP\fIdelim\fP\fB,\fP
\fB                wchar_t **restrict \fP\fIptr\fP\fB);\fP
.fi
.SH الوصف
الدالة \fBwcstok\fP() هي المكافئ عريض المحارف للدالة \fBstrtok\fP(3)، مع وسيط
إضافي لجعلها آمنة للخيوط المتعددة. يمكن استخدامها لتقسيم سلسلة محارف عريضة
\fIwcs\fP إلى رموز، حيث يُعرَّف الرمز على أنه سلسلة فرعية لا تحتوي على أي محارف
عريضة من \fIdelim\fP.
.P
يبدأ البحث عند \fIwcs\fP، إذا لم يكن \fIwcs\fP NULL، أو عند \fI*ptr\fP، إذا كان
\fIwcs\fP NULL. أولاً، تُتجاوز أي محارف عريضة فاصلة، أي يُقدَّم المؤشر بعد أي
محارف عريضة تظهر في \fIdelim\fP. إذا وُصل الآن إلى نهاية سلسلة المحارف العريضة،
تُرجع \fBwcstok\fP() NULL، للإشارة إلى عدم العثور على رموز، وتُخزِّن قيمة
مناسبة في \fI*ptr\fP، بحيث تستمر الاستدعاءات اللاحقة لـ \fBwcstok\fP() في إرجاع
NULL. وإلا، تتعرف الدالة \fBwcstok\fP() على بداية رمز وتُرجِع مؤشرًا إليه، ولكن
قبل ذلك، تُنهي الرمز بصفر عن طريق استبدال المحرف العريض التالي الذي يظهر في
\fIdelim\fP بمحرف عريض فارغ (L\[aq]\[rs]0\[aq])، وتُحدِّث \fI*ptr\fP بحيث تستمر
الاستدعاءات اللاحقة في البحث بعد نهاية الرمز المُعرَّف.
.SH "قيمة الإرجاع"
تُرجع الدالة \fBwcstok\fP() مؤشرًا إلى الرمز التالي، أو NULL إذا لم يُعثر على
رمز آخر.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBwcstok\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
POSIX.1\-2001، C99.
.SH ملاحظات
تُعدَّل سلسلة المحارف العريضة الأصلية \fIwcs\fP تعديلاً إتلافيًا أثناء العملية.
.SH أمثلة
يتنقل الكود التالي عبر الرموز الموجودة في سلسلة محارف عريضة.
.P
.EX
wchar_t *wcs = ...;
wchar_t *token;
wchar_t *state;
for (token = wcstok(wcs, L" \[rs]t\[rs]n", &state);
    token != NULL;
    token = wcstok(NULL, L" \[rs]t\[rs]n", &state)) {
    ...
}
.EE
.SH "انظر أيضًا"
\fBstrtok\fP(3), \fBwcschr\fP(3)
.PP
.SH ترجمة
تُرجمت هذه الصفحة من الدليل بواسطة
زايد السعيدي <zayed.alsaidi@gmail.com>
.
.PP
هذه الترجمة هي وثيقة مجانية؛ راجع
.UR https://www.gnu.org/licenses/gpl-3.0.html 
رخصة جنو العامة الإصدار 3
.UE
أو ما بعده للاطلاع على شروط حقوق النشر.
لا توجد أي ضمانات.
.PP
إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه،
يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين:
.MT kde-l10n-ar@kde.org
.ME .