.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 1993, Thomas Koenig .\" Copyright 2014, Michael Kerrisk .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH toupper 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" .SH الاسم toupper, tolower, toupper_l, tolower_l \- تحويل الأحرف الكبيرة أو الصغيرة .SH المكتبة مكتبة سي المعيارية (\fIlibc\fP،\ \fI\-lc\fP) .SH موجز .nf \fB#include \fP .P \fBint toupper(int \fP\fIc\fP\fB);\fP \fBint tolower(int \fP\fIc\fP\fB);\fP .P \fBint toupper_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP \fBint tolower_l(int \fP\fIc\fP\fB, locale_t \fP\fIlocale\fP\fB);\fP .fi .P .RS -4 متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)): .RE .P \fBtoupper_l\fP()، \fBtolower_l\fP(): .nf منذ glibc 2.10: _XOPEN_SOURCE >= 700 قبل glibc 2.10: _GNU_SOURCE .fi .SH الوصف تحوِّل هذه الدوال الأحرف الصغيرة إلى كبيرة، والعكس. .P إذا كان \fIc\fP حرفًا صغيرًا، تُرجع \fBtoupper\fP() نظيره الكبير، إن وُجد تمثيل كبير في الإعدادات المحلية الحالية. وإلا، تُرجع \fIc\fP. تؤدي الدالة \fBtoupper_l\fP() نفس المهمة، لكنها تستخدم الإعدادات المحلية المشار إليها بمقبض الإعدادات المحلية \fIlocale\fP. .P إذا كان \fIc\fP حرفًا كبيرًا، تُرجع \fBtolower\fP() نظيره الصغير، إن وُجد تمثيل صغير في الإعدادات المحلية الحالية. وإلا، تُرجع \fIc\fP. تؤدي الدالة \fBtolower_l\fP() نفس المهمة، لكنها تستخدم الإعدادات المحلية المشار إليها بمقبض الإعدادات المحلية \fIlocale\fP. .P إذا لم يكن \fIc\fP قيمة من نوع \fIunsigned char\fP ولا \fBEOF\fP، يكون سلوك هذه الدوال غير مُعرَّف. .P يكون سلوك \fBtoupper_l\fP() و \fBtolower_l\fP() غير مُعرَّف إذا كان \fIlocale\fP هو كائن الإعدادات المحلية الخاص \fBLC_GLOBAL_LOCALE\fP (انظر \fBduplocale\fP(3)) أو لم يكن مقبض كائن إعدادات محلية صالحًا. .SH "قيمة الإرجاع" القيمة المُرجَعة هي قيمة الحرف المُحوَّل، أو \fIc\fP إذا لم يكن التحويل ممكنًا. .SH السمات للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. الواجهة السمة القيمة T{ .na .nh \fBtoupper\fP()، \fBtolower\fP()، \fBtoupper_l\fP()، \fBtolower_l\fP() T} سلامة الخيوط MT\-Safe .TE .SH المعايير .TP \fBtoupper\fP() .TQ \fBtolower\fP() C11, POSIX.1\-2008. .TP \fBtoupper_l\fP() .TQ \fBtolower_l\fP() POSIX.1\-2008. .SH التاريخ .TP \fBtoupper\fP() .TQ \fBtolower\fP() C89، 4.3BSD، POSIX.1\-2001. .TP \fBtoupper_l\fP() .TQ \fBtolower_l\fP() POSIX.1\-2008. .SH ملاحظات تتطلب المعايير أن يكون المعامل \fIc\fP لهذه الدوال إما \fBEOF\fP أو قيمة قابلة للتمثيل في النوع \fIunsigned char\fP. إذا كان المعامل \fIc\fP من النوع \fIchar\fP، يجب تحويله إلى \fIunsigned char\fP، كما في المثال التالي: .P .in +4n .EX char c; \&... res = toupper((unsigned char) c); .EE .in .P هذا ضروري لأن \fIchar\fP قد يكون مكافئًا لـ \fIsigned char\fP، وفي هذه الحالة، سيتم تمديد إشارة بايت حيث تكون البتة العليا مضبوطة عند التحويل إلى \fIint\fP، مما يُنتج قيمة خارج نطاق \fIunsigned char\fP. .P تختلف تفاصيل ما يُعتبر حرفًا كبيرًا أو صغيرًا باختلاف اللغة. على سبيل المثال، لا تتعرف اللغة المبدئية \fB\[dq]C\[dq]\fP على الأحرف ذات النبرة، لذا لا يُجرى أي تحويل لها. .P .\" FIXME One day the statement about "sharp s" needs to be reworked, .\" since there is nowadays a capital "sharp s" that has a codepoint .\" in Unicode 5.0; see https://en.wikipedia.org/wiki/Capital_%E1%BA%9E في بعض الإعدادات المحلية غير الإنجليزية، توجد أحرف صغيرة ليس لها نظير كبير مقابل؛ الحرف الألماني sharp s هو أحد الأمثلة. .SH "انظر أيضًا" \fBisalpha\fP(3)، \fBnewlocale\fP(3)، \fBsetlocale\fP(3)، \fBtowlower\fP(3)، \fBtowupper\fP(3)، \fBuselocale\fP(3)، \fBlocale\fP(7) .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .