.\" -*- coding: UTF-8 -*-
'\" t
.\" Copyright 1993, David Metcalfe <david@prism.demon.co.uk>
.\" 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 asin 3 "8 فبراير 2026" "صفحات دليل لينكس 6.18" 
.SH الاسم
asin, asinf, asinl \- دالة قوس الجيب
.SH المكتبة
مكتبة الرياضيات (\fIlibm\fP،\ \fI\-lm\fP)
.SH موجز
.nf
\fB#include <math.h>\fP
.P
\fBdouble asin(double \fP\fIx\fP\fB);\fP
\fBfloat asinf(float \fP\fIx\fP\fB);\fP
\fBlong double asinl(long double \fP\fIx\fP\fB);\fP
.fi
.P
.RS -4
متطلبات ماكروات اختبار الميزات لـ glibc (انظر \fBfeature_test_macros\fP(7)):
.RE
.P
\fBasinf\fP(), \fBasinl\fP():
.nf
    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
        || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
.fi
.SH الوصف
تحسب هذه الدوال القيمة الرئيسية لقوس جيب \fIx\fP؛ أي القيمة التي جيبها هو \fIx\fP.
.SH "قيمة الإرجاع"
عند النجاح، تُرجع هذه الدوال القيمة الرئيسية لقوس جيب \fIx\fP بالراديان؛ وتكون
القيمة المُرجعة في النطاق [\-pi/2,\ pi/2].
.P
إذا كانت \fIx\fP ليست رقماً (NaN)، فسيُعاد NaN.
.P
إذا كانت \fIx\fP هي +0 (\-0)، فُيعاد +0 (\-0).
.P
.\"
.\" POSIX.1-2001 documents an optional range error for subnormal x;
.\" glibc 2.8 does not do this.
إذا كان \fIx\fP خارج النطاق [\-1,\ 1]، يحدث خطأ في النطاق، ويُعاد NaN.
.SH الأخطاء
انظر \fBmath_error\fP(7) لمعلومات حول كيفية تحديد ما إذا كان قد حدث خطأ عند
استدعاء هذه الدوال.
.P
الأخطاء التالية يمكن أن تحدث:
.TP 
خطأ في النطاق: \f[I]x\fR خارج النطاق [\-1,\ 1]
تُضبط \fIerrno\fP على \fBEDOM\fP. وُيرفع استثناء نقطة عائمة غير صالح
(\fBFE_INVALID\fP).
.SH السمات
للاطلاع على شرح للمصطلحات المستخدمة في هذا القسم، انظر \fBattributes\fP(7).
.TS
allbox;
lbx lb lb
l l l.
الواجهة	السمة	القيمة
T{
.na
.nh
\fBasin\fP(),
\fBasinf\fP(),
\fBasinl\fP()
T}	سلامة الخيوط	MT\-Safe
.TE
.SH المعايير
C11, POSIX.1\-2008.
.SH التاريخ
C99، POSIX.1\-2001.
.P
النسخة التي تُعيد \fIdouble\fP تتوافق أيضًا مع SVr4، و 4.3BSD، و C89.
.SH "انظر أيضًا"
\fBacos\fP(3), \fBatan\fP(3), \fBatan2\fP(3), \fBcasin\fP(3), \fBcos\fP(3), \fBsin\fP(3),
\fBtan\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 .