مولد تعليقات الشيفرة

الإدخال

Language

python

Code

def chunk_list(lst, n): return [lst[i:i+n] for i in range(0, len(lst), n)]

الإخراج (مقتطف)

```python
def chunk_list(lst, n):
    """
    تقسيم قائمة إلى قوائم فرعية متتالية بطول ``n``.

    قد تكون القائمة الفرعية الأخيرة أقصر من ``n`` إذا لم يكن ``len(lst)``
    عددًا مضاعفًا دقيقًا لـ ``n``. يتم الحفاظ على الترتيب.

    المعاملات:
        lst: القابل للتكرار المصدر، محوَّل إلى تسلسل شبيه بالقائمة.
        n: حجم الجزء. يجب أن يكون عددًا صحيحًا موجبًا.

    الإرجاع:
        قائمة من القوائم، حيث كل قائمة داخلية هي شريحة متصلة من ``lst``.

    مثال:
        >>> chunk_list([1, 2, 3, 4, 5], 2)
        [[1, 2], [3, 4], [5]]
    """
    return [lst[i:i+n] for i in range(0, len(lst), n)]
```

الإدخال

Language

javascript

Code

function debounce(fn, ms){let t;return function(...args){clearTimeout(t);t=setTimeout(()=>fn.apply(this,args),ms);};}

الإخراج (مقتطف)

```javascript
/**
 * تغليف دالة بحيث يتم دمج الاستدعاءات التي تفصلها أقل من ``ms`` مللي ثانية
 * في استدعاء نهائي واحد. مفيد لتقليل العمل عند
 * تغيير الحجم، التمرير، أو أحداث الإدخال السريعة.
 *
 * @param {Function} fn - الدالة المراد تقليل تكرارها.
 * @param {number} ms - فترة الصمت بالمللي ثانية.
 * @returns {Function} غلاف مخفض للتكرار يحافظ على ``this`` والمعاملات.
 *
 * @example
 *   window.addEventListener('resize', debounce(layout, 200));
 */
function debounce(fn, ms) {
  let t;
  return function (...args) {
    clearTimeout(t);
    t = setTimeout(() => fn.apply(this, args), ms);
  };
}
```

الإدخال

Language

sql

Code

CREATE PROCEDURE ArchiveOldOrders @Days INT AS BEGIN INSERT INTO orders_archive SELECT * FROM orders WHERE created_at < DATEADD(day,-@Days,GETUTCDATE()); DELETE FROM orders WHERE created_at < DATEADD(day,-@Days,GETUTCDATE()); END

الإخراج (مقتطف)

```sql
-- ArchiveOldOrders
-- نقل الصفوف الأقدم من @Days من جدول `orders` إلى `orders_archive`،
-- ثم إزالتها من الجدول الحي.
--
-- @Days: الحد الأدنى للعمر بالأيام. الصفوف التي يكون `created_at < UTC_NOW - @Days`
--        مؤهلة للأرشفة.
--
-- ملاحظات:
--   * غلف العملية داخل معاملة في بيئة الإنتاج لتجنب الأرشفة الجزئية.
--   * يجب وجود فهارس على orders.created_at + orders_archive لتضمن
--     تشغيل العملية في ثوانٍ بدلاً من دقائق على جداول تحتوي أكثر من مليون صف.
--   * استخدم توقيت UTC بشكل ثابت — الوقت المحلي للخادم سيتغير مع التوقيت الصيفي.
CREATE PROCEDURE ArchiveOldOrders @Days INT AS
BEGIN
  INSERT INTO orders_archive
    SELECT * FROM orders
    WHERE created_at < DATEADD(day, -@Days, GETUTCDATE());
  DELETE FROM orders
    WHERE created_at < DATEADD(day, -@Days, GETUTCDATE());
END
```