ecvt(3)

الاسم
ecvt, fcvt - تحويل رقم عائم إلى سلسلة محارف

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

موجز
#include <stdlib.h>

[[deprecated]] char *ecvt(double number, int ndigits,
                          int *restrict decpt, int *restrict sign);
[[deprecated]] char *fcvt(double number, int ndigits,
                          int *restrict decpt, int *restrict sign);

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

ecvt()، fcvt():
    منذ glibc 2.17
        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200809L))
            || /* glibc >= 2.20 */ _DEFAULT_SOURCE
            || /* glibc <= 2.19 */ _SVID_SOURCE
    glibc 2.12 إلى glibc 2.16:
        (_XOPEN_SOURCE >= 500 && ! (_POSIX_C_SOURCE >= 200112L))
            || _SVID_SOURCE
    قبل glibc 2.12:
        _SVID_SOURCE || _XOPEN_SOURCE >= 500

الوصف
تحوِّل الدالة ecvt() الرقم الرقم إلى سلسلة محارف منتهية بقيمة فارغة مكونة من عدد_الأرقام رقمًا (حيث يُختزل عدد_الأرقام إلى حد خاص بالنظام يُحدد بدقة double)، وتُعيد مؤشرًا إلى السلسلة. الرقم ذو الترتيب الأعلى غير صفري، ما لم يكن الرقم صفرًا. يُقرَّب الرقم ذو الترتيب الأدنى. لا تحتوي السلسلة نفسها على نقطة عشرية؛ ومع ذلك، يُخزَّن موضع النقطة العشرية بالنسبة لبداية السلسلة في *العلامة_العشرية. تعني القيمة السالبة لـ *العلامة_العشرية أن النقطة العشرية تقع على يسار بداية السلسلة. إذا كانت إشارة الرقم سالبة، تُضبط *الإشارة إلى قيمة غير صفرية، وإلا تُضبط إلى 0. إذا كان الرقم صفرًا، فلا يُحدد ما إذا كان *العلامة_العشرية هو 0 أو 1.

الدالة fcvt() مطابقة لـ ecvt()، باستثناء أن عدد_الأرقام يُحدد عدد الأرقام بعد النقطة العشرية.

قيمة الإرجاع
تُعيد كلتا الدالتين ecvt() و fcvt() مؤشرًا إلى سلسلة محارف ثابتة تحتوي على تمثيل ASCII لـ الرقم. تُستبدل السلسلة الثابتة مع كل استدعاء لـ ecvt() أو fcvt().

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

المعايير
لا شيء.

التاريخ
SVr2؛ وُسِمَ كـ LEGACY في POSIX.1-2001. أزال POSIX.1-2008 مواصفات ecvt() و fcvt()، مُوصيًا باستخدام sprintf(3) بدلاً من ذلك (على الرغم من أن snprintf(3) قد يكون أفضل).

ملاحظات
لا تستخدم جميع الإعدادات المحلية النقطة كحرف أساس ("النقطة العشرية").

انظر أيضًا
ecvt_r(3)، gcvt(3)، qecvt(3)، setlocale(3)، sprintf(3)

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

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

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