.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 2014, Michael Kerrisk <mtk.manpages@gmail.com>
.\" 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 towupper 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
towupper, towupper_l \- تحويل محرف عريض إلى حرف كبير
.SH المكتبة
مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP)
.SH موجز
.nf
\fB#include <wctype.h>\fP
.P
\fBwint_t towupper(wint_t \fP\fIwc\fP\fB);\fP
\fBwint_t towupper_l(wint_t \fP\fIwc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBtowupper_l\fP():
.nf
    منذ glibc 2.10:
        _XOPEN_SOURCE >= 700
    قبل glibc 2.10:
        _GNU_SOURCE
.fi
.SH الوصف
الدالة \fBtowupper\fP() هي المكافئ للمحرف العريض للدالة \fBtoupper\fP(3). إذا كان
\fIwc\fP محرفًا عريضًا صغيرًا، وكان هناك مقابل كبير في اللغة الحالية، فإنها
تُرجع المقابل الكبير لـ \fIwc\fP. في جميع الحالات الأخرى، يُعاد \fIwc\fP دون
تغيير.
.P
الدالة \fBtowupper_l\fP() تؤدي نفس المهمة، لكنها تُجري التحويل بناءً على
معلومات نوع المحرف في اللغة المحددة بواسطة \fIlocale\fP. سلوك \fBtowupper_l\fP()
غير مُعرّف إذا كان \fIlocale\fP هو كائن اللغة الخاص \fBLC_GLOBAL_LOCALE\fP (انظر
\fBduplocale\fP(3)) أو لم يكن مقبض كائن لغة صالحًا.
.P
يجب أن يكون المعامل \fIwc\fP قابلاً للتمثيل كـ \fIwchar_t\fP ومحرفًا صالحًا في
المحلية أو يكون القيمة \fBWEOF\fP.
.SH "قيمة الإرجاع"
إذا كان \fIwc\fP قابلًا للتحويل إلى كبير، تُرجع \fBtowupper\fP() مقابله الكبير؛
وإلا تُرجع \fIwc\fP.
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBtowupper\fP()
T}	سلامة الخيوط	المنطقة (locale) آمنة لتعدد المسالك (MT\-Safe)
T{
.na
.nh
\fBtowupper_l\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
.TP 
\fBtowupper\fP()
C11، POSIX.1\-2008 (XSI).
.TP 
\fBtowupper_l\fP()
POSIX.1\-2008.
.SH التاريخ
.TP 
\fBtowupper\fP()
C99, POSIX.1\-2001 (XSI). مهجور في POSIX.1\-2008 (XSI).
.TP 
\fBtowupper_l\fP()
POSIX.1\-2008.  glibc 2.3.
.SH ملاحظات
يعتمد سلوك هذه الدوال على فئة \fBLC_CTYPE\fP للمحلية.
.P
هذه الدوال ليست مناسبة جدًا للتعامل مع محارف يونيكود، لأن يونيكود يعرف ثلاث
حالات: حالة الأحرف الكبيرة، والصغيرة، وحالة العنوان.
.SH "انظر أيضًا"
\fBiswupper\fP(3), \fBtowctrans\fP(3), \fBtowlower\fP(3), \fBlocale\fP(7)
.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 .