cnl

مكتبة رقمية تكوين

المكتبة الرقمية التركيبية (CNL) هي مكتبة C ++ من الفئات الرقمية ذات الدقة الثابتة التي تعزز الأعداد الصحيحة لتقديم أنواع أكثر أمانًا وأبسطًا وأرخص. يمكن العثور على الوثائق هنا. يمكنك تجربة CNL على Explorer برنامج التحويل البرمجي هنا.

CNL مناسبة بشكل خاص ل:

• حساب أو البيئات المقيدة للطاقة حيث FPUs غائبة أو مكلفة ؛
• حساب أو بيئات كثيفة الطاقة حيث يكون الحساب عنق الزجاجة مثل المحاكاة وتطبيقات التعلم الآلي و DSPs ؛ و
• مجالات مثل التمويل حيث تكون الدقة ضرورية.

متطلبات

يتطلب أحدث إصدار من CNL سلسلة أدوات متوافقة مع C ++ 20. (الإصدار 1.x يدعم C ++ 11.) يتم اختبار CNL باستمرار على الأنظمة التالية:

Linux

تم اختباره:

• GCC 10 ، 11 ، 12
• Clang 10 ، 11 ، 12 ، 13 ، 14
• libstdc ++ 10 ، 11 ، 12
• libc ++ 13 ، 14
• Cmake 3.23.1
• كونان 1.48.1

OS X.

تم اختباره:

• GCC 11 / Clang 13
• Cmake 3.23.1
• كونان 1.48.1

النوافذ

تم اختباره:

• Visual Studio 2019 الإصدار 16 (19.29.30145.0)
• Visual Studio 2022 الإصدار 17 (19.32.31329.0)
• Cmake 3.23.1
• كونان 1.48.1

تعليمات

يبني

يتم توفير البرامج النصية cmake.

• لبناء وتثبيت CNL على نظامك:

mkdir build && cd build
cmake ..
cmake --build . --target install

ملاحظة: قد تحتاج إلى امتيازات المستخدم لتثبيت المكتبة. بدلاً من ذلك ، يمكنك التثبيت على دليل المستخدم باستخدام CMAKE_INSTALL_PREFIX :

mkdir build && cd build
cmake -DCMAKE_INSTALL_PREFIX:FILE=/home/username/someplace ..
cmake --build . --target install

بدلاً من ذلك ، CNL هي مكتبة رأس فقط حتى تتمكن ببساطة من الإشارة إلى دليل تضمين

c++ -isystem /path/to/cnl/include -std=c++20 my_program.cpp

أو حتى قم بتضمين رأس الجذر مباشرة في الكود الخاص بك:

# include " /path/to/cnl/include/cnl/all.h "

امتحان

يستخدم مجموعة الاختبار CMake ويعتمد على اختبار Google و Google Conclenk. اختبارات التكامل الاختيارية تستخدم Boost.MultiPreCision.

1. يمكن استخدام كونان لسحب التبعيات الأساسية. يفترض هذا المثال GCC ولكن يتم توفير ملفات سلسلة الأدوات الأخرى:

    cd build
   conan profile new --detect --force default
   conan profile update settings.compiler.libcxx=libstdc++11 default  # GCC/Clang only
   conan profile update env.CONAN_CMAKE_TOOLCHAIN_FILE=../test/toolchain/gcc.cmake default # GCC only
   conan install --build=missing --options test=unit ..

   ... ثم تكوين وإنشاء وتشغيل اختبارات الوحدة:

   conan build --configure --build --test ..

2. لتشغيل المعايير ، استخدم --options test=benchmark ...

   conan install --build=missing --options test=benchmark ..

   ثم تكوين وبناء

   conan build --configure --build ..

   وأخيراً قم بتشغيلها بشكل صريح لرؤية النتائج.

   ./test/benchmark/test-benchmark

اندماج

يتم كشف واجهة برمجة التطبيقات من خلال الرؤوس في الدليل. أضف هذا إلى قائمة رأس النظام الخاصة بك وتضمينه ، على سبيل المثال:

 // to use a specific type:
# include < cnl/scaled_integer.h >

// or to include all CNL types:
# include < cnl/all.h > 

مثال المشاريع

أمثلة على المشاريع باستخدام CNL:

• CDSP - مكتبة DSP التكوين لـ C ++ ؛
• البرامج الثابتة Brewblox - البرامج الثابتة لوحدة التحكم في مصنع الجعة
• CNL_EXAMPLE - المشروع القائم على CMAKE الحد الأدنى والذي يستخدم CNL كاعتماد.

مزيد من القراءة

• وثائق CNL
• عرض CPPCON 2017
• مقالة فنية مضمنة
• أوراق ISO C ++:
  • P0037 - أرقام حقيقية نقطة ثابتة
  • P0554 - تكوين الأنواع الحسابية
  • P0827 - نوع القيمة الثابتة للأغراض العامة
  • P0828 - أعداد صحيحة مرنة
  • P1050 - نوع رقمي كسري

بدائل

• يمكن إرجاع الكثير من البساطة والكفاءة في تصميم API من CNL إلى مكتبة نقطة FP الثابتة لـ Matheus Izvekov.
• جنبا إلى جنب مع ورقة النقطة الثابتة في لورانس كراول ، p0106 ، فإنه يضع الأساس لتقريب العدد الحقيقي المدعوم من عدد صحيح يقلل من فقدان الأداء والدقة.
• FPM هي مكتبة رياضيات نقطة ثابتة مع كمية عالية من الوظائف الرياضية.
• فئة النقطة الثابتة هي حل C ++ 98 من Header من Peter Schregle.

معلومات الاتصال

كل ردود الفعل موضع تقدير كبير.

• قضايا CNL
• [email protected]