;
/** Allows creating an aggregate function by its name.
*/
class AggregateFunctionFactory
{
public:
AggregateFunctionFactory();
AggregateFunctionPtr get(const String & name, const DataTypes & argument_types) const;
```
**15.** `namespace`.
لا حاجة إلى استخدام `namespace` منفصل لشيفرة التطبيق.
ولا تحتاج المكتبات الصغيرة إلى ذلك أيضًا.
أما في المكتبات المتوسطة والكبيرة، فضع كل شيء داخل `namespace`.
في ملف `.h` الخاص بالمكتبة، يمكنك استخدام `namespace detail` لإخفاء تفاصيل التنفيذ غير اللازمة لشيفرة التطبيق.
وفي ملف `.cpp`، يمكنك استخدام `static` أو `namespace` مجهول لإخفاء الرموز.
كذلك، يمكن استخدام `namespace` مع `enum` لمنع تسرّب الأسماء المقابلة إلى `namespace` خارجي (لكن من الأفضل استخدام `enum class`).
**16.** التهيئة المؤجلة.
إذا كانت التهيئة تتطلب معاملات، فعادةً لا ينبغي لك كتابة مُنشئ افتراضي.
وإذا احتجت لاحقًا إلى تأجيل التهيئة، فيمكنك إضافة مُنشئ افتراضي ينشئ كائنًا غير صالح. أو، إذا كان عدد الكائنات قليلًا، يمكنك استخدام `shared_ptr/unique_ptr`.
```cpp theme={null}
Loader(DB::Connection * connection_, const std::string & query, size_t max_block_size_);
/// For deferred initialization
Loader() {}
```
**17.** الدوال الافتراضية.
إذا لم يكن الصنف مخصّصًا للاستخدام متعدد الأشكال، فلا حاجة إلى جعل الدوال افتراضية. وينطبق ذلك أيضًا على الدالة الهادمة.
**18.** الترميزات.
استخدم UTF-8 في كل مكان. استخدم `std::string` و `char *`. لا تستخدم `std::wstring` و `wchar_t`.
**19.** التسجيل.
راجع الأمثلة في مختلف أنحاء الشيفرة.
قبل إجراء `commit`، احذف كل رسائل السجل غير المفيدة ورسائل Debug، وأي أنواع أخرى من مخرجات Debug.
يجب تجنّب التسجيل داخل الحلقات، حتى على مستوى Trace.
يجب أن تكون السجلات قابلة للقراءة عند أي مستوى من مستويات التسجيل.
ينبغي استخدام التسجيل في شيفرة التطبيق فقط، في الغالب.
يجب أن تُكتب رسائل السجل باللغة الإنجليزية.
ويُفضَّل أن يكون السجل مفهومًا لمسؤول النظام.
لا تستخدم الألفاظ النابية في السجل.
استخدم ترميز UTF-8 في السجل. وفي حالات نادرة، يمكنك استخدام محارف غير ASCII في السجل.
**20.** الإدخال والإخراج.
لا تستخدم `iostreams` في الحلقات الداخلية الحسّاسة لأداء التطبيق (ولا تستخدم `stringstream` أبدًا).
استخدم مكتبة `DB/IO` بدلًا من ذلك.
**21.** التاريخ والوقت.
راجع مكتبة `DateLUT`.
**22.** include.
استخدم دائمًا `#pragma once` بدلًا من حواجز التضمين.
**23.** using.
لا تستخدم `using namespace`. يمكنك استخدام `using` لشيء محدد، لكن اجعله محليًا داخل صنف أو دالة.
**24.** لا تستخدم `trailing return type` للدوال إلا عند الضرورة.
```cpp theme={null}
auto f() -> void
```
**25.** التصريح عن المتغيرات وتهيئتها.
```cpp theme={null}
//right way
std::string s = "Hello";
std::string s{"Hello"};
//wrong way
auto s = std::string{"Hello"};
```
**26.** بالنسبة إلى الدوال الافتراضية، اكتب `virtual` في الصنف الأساسي، لكن اكتب `override` بدلًا من `virtual` في الأصناف الفرعية.
## ميزات C++ غير المستخدمة
**1.** لا يُستخدم التوريث الافتراضي.
**2.** التراكيب التي تتوفر لها اختصارات نحوية مريحة في C++ الحديثة، مثلًا.
```cpp theme={null}
// Traditional way without syntactic sugar
template ::value, void>> // SFINAE via std::enable_if, usage of ::value
std::pair func(const E & e) // explicitly specified return type
{
if (elements.count(e)) // .count() membership test
{
// ...
}
elements.erase(
std::remove_if(
elements.begin(), elements.end(),
[&](const auto x){
return x == 1;
}),
elements.end()); // remove-erase idiom
return std::make_pair(1, 2); // create pair via make_pair()
}
// With syntactic sugar (C++14/17/20)
template
requires std::same_v // SFINAE via C++20 concept, usage of C++14 template alias
auto func(const E & e) // auto return type (C++14)
{
if (elements.contains(e)) // C++20 .contains membership test
{
// ...
}
elements.erase_if(
elements,
[&](const auto x){
return x == 1;
}); // C++20 std::erase_if
return {1, 2}; // or: return std::pair(1, 2); // create pair via initialization list or value initialization (C++17)
}
```
## المنصة
**1.** نكتب الشفرة البرمجية لمنصة محددة.
لكن عند تساوي العوامل الأخرى، تُفضَّل الشفرة متعددة المنصات أو القابلة للنقل.
**2.** اللغة: C++20 (راجع قائمة [ميزات C++20](https://en.cppreference.com/w/cpp/compiler_support#C.2B.2B20_features) المتاحة).
**3.** المترجم: `clang`. وقت كتابة هذا النص (مارس 2025)، تُترجم الشفرة البرمجية باستخدام clang بالإصدار >= 19.
تُستخدم المكتبة القياسية (`libc++`).
**4.** نظام التشغيل: Ubuntu Linux، على ألا يكون أقدم من Precise.
**5.** تُكتب الشفرة البرمجية لمعمارية CPU من نوع x86\_64.
مجموعة تعليمات CPU هي الحد الأدنى المدعوم بين خوادمنا. وهي حاليًا SSE 4.2.
**6.** استخدم أعلام الترجمة `-Wall -Wextra -Werror -Weverything` مع بعض الاستثناءات.
**7.** استخدم الربط الثابت مع جميع المكتبات باستثناء تلك التي يصعب ربطها ربطًا ثابتًا (راجع خرج الأمر `ldd`).
**8.** تُطوَّر الشفرة البرمجية ويُجرى Debug لها باستخدام إعدادات الإصدار.
## الأدوات
**1.** يُعد KDevelop بيئة تطوير متكاملة جيدة.
**2.** لتصحيح الأخطاء، استخدم `gdb` و`valgrind` (`memcheck`) و`strace` و`-fsanitize=...` أو `tcmalloc_minimal_debug`.
**3.** لتحليل الأداء، استخدم `Linux Perf` أو `valgrind` (`callgrind`) أو `strace -cf`.
**4.** الشيفرة المصدرية موجودة في Git.
**5.** يُستخدم `CMake` للبناء.
**6.** تُصدر البرامج باستخدام حزم `deb`.
**7.** يجب ألا تؤدي عمليات commit على `master` إلى كسر عملية البناء.
مع أن مراجعات محددة فقط تُعد صالحة للعمل.
**8.** نفّذ عمليات commit بأكبر قدر ممكن من التكرار، حتى لو كانت الشيفرة جاهزة جزئيًا فقط.
استخدم الفروع لهذا الغرض.
إذا كانت الشيفرة الخاصة بك في فرع `master` غير قابلة للبناء بعد، فاستبعدها من عملية البناء قبل `push`. ستحتاج إلى إكمالها أو إزالتها خلال بضعة أيام.
**9.** بالنسبة إلى التغييرات غير البسيطة، استخدم الفروع وانشرها على الخادم.
**10.** تُزال الشيفرة غير المستخدمة من المستودع.
## المكتبات
**1.** تُستخدم مكتبة C++20 القياسية (ويُسمح بالامتدادات التجريبية)، وكذلك إطارا العمل `boost` و`Poco`.
**2.** لا يُسمح باستخدام مكتبات من حزم نظام التشغيل، كما لا يُسمح باستخدام المكتبات المثبّتة مسبقًا. يجب وضع جميع المكتبات على هيئة شيفرة مصدرية في دليل `contrib` وبنائها مع ClickHouse. راجع [إرشادات إضافة مكتبات خارجية جديدة وصيانتها](/ar/resources/develop-contribute/contribute/contrib#adding-and-maintaining-third-party-libraries) لمزيد من التفاصيل.
**3.** تُمنح الأفضلية دائمًا للمكتبات المستخدمة مسبقًا.
## توصيات عامة
**1.** اكتب أقل قدر ممكن من الشيفرة.
**2.** جرّب أبسط حل ممكن.
**3.** لا تكتب شيفرة قبل أن تعرف كيف ستعمل، وكيف ستعمل الحلقة الداخلية.
**4.** في أبسط الحالات، استخدم `using` بدلًا من الأصناف أو البُنى.
**5.** إذا أمكن، فلا تكتب copy constructors أو assignment operators أو destructors (باستثناء destructor افتراضي، إذا كان الصنف يحتوي على دالة افتراضية واحدة على الأقل) أو move constructors أو move assignment operators. وبعبارة أخرى، يجب أن تعمل الدوال التي يُنشئها المصرّف تلقائيًا بشكل صحيح. يمكنك استخدام `default`.
**6.** يُشجَّع تبسيط الشيفرة. قلّل حجم الشيفرة قدر الإمكان.
## توصيات إضافية
**1.** عدم التصريح بـ `std::` صراحةً للأنواع القادمة من `stddef.h`
غير مستحسن. بمعنى آخر، نوصي بكتابة `size_t` بدلًا من `std::size_t` لأنه أقصر.
ومع ذلك، لا بأس بإضافة `std::`.
**2.** عدم التصريح بـ `std::` صراحةً للدوال القادمة من مكتبة C القياسية
غير مستحسن. بمعنى آخر، اكتب `memcpy` بدلًا من `std::memcpy`.
والسبب هو وجود دوال مشابهة غير قياسية، مثل `memmem`. ونحن نستخدم هذه الدوال أحيانًا. وهذه الدوال غير موجودة في `namespace std`.
إذا كتبت `std::memcpy` بدلًا من `memcpy` في كل مكان، فسيبدو `memmem` من دون `std::` غريبًا.
ومع ذلك، يمكنك استخدام `std::` إذا كنت تفضل ذلك.
**3.** استخدام دوال من C عندما تكون الدوال نفسها متاحة في مكتبة C++ القياسية.
هذا مقبول إذا كان أكثر كفاءة.
على سبيل المثال، استخدم `memcpy` بدلًا من `std::copy` لنسخ كتل كبيرة من الذاكرة.
**4.** وسيطات الدالة متعددة الأسطر.
أيٌّ من أنماط التفاف الأسطر التالية مسموح به:
```cpp theme={null}
function(
T1 x1,
T2 x2)
```
```cpp theme={null}
function(
size_t left, size_t right,
const & RangesInDataParts ranges,
size_t limit)
```
```cpp theme={null}
function(size_t left, size_t right,
const & RangesInDataParts ranges,
size_t limit)
```
```cpp theme={null}
function(size_t left, size_t right,
const & RangesInDataParts ranges,
size_t limit)
```
```cpp theme={null}
function(
size_t left,
size_t right,
const & RangesInDataParts ranges,
size_t limit)
```