代码注释生成器

输入

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`` 的连续子列表。

    如果 ``len(lst)`` 不是 ``n`` 的整数倍，最后一个子列表可能短于 ``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`` 毫秒的调用合并为一次尾随调用。用于限制在
 * resize、scroll 或快速输入事件上的工作。
 *
 * @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
-- 将 `orders` 中早于 @Days 的行移动到 `orders_archive`，
-- 然后从实时表中删除这些行。
--
-- @Days：以天为单位的截止年龄。满足 `created_at < UTC_NOW - @Days` 的行可归档。
--        可归档。
--
-- 注意：
--   * 在生产环境中使用事务包装，以避免部分归档。
--   * 应在 orders.created_at 和 orders_archive 上建立索引，以便
--     在超过 100 万行的表上能够在秒级而非分钟级运行。
--   * 始终使用 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
```