bitmap_subset_limit
功能
根据指定的起始值,从 BITMAP 中截取指定个数的元素。返回的元素是 Bitmap 的子集。
该函数从 3.1 版本开始支持,主要用于分页查询场景。
该函数与 sub_bitmap 功能相似,不同之处在于 sub_bitmap 指定的是 offset,bitmap_subset_limit 指定的是起始值。
语法
BITMAP bitmap_subset_limit(BITMAP src, BIGINT start_range, BIGINT limit)
参数说明
src: 要截取的目标 bitmap。start_range: 用于指定起始值,必须是 BIGINT 类型。如果指定的起始值超过了 Bitmap 的最大长度并且limit是正数,则返回 NULL。参见示例四。limit: 从start_range开始,要截取的元素个数,必须是 BIGINT 类型。如果取值为负,表示从start_range开始由右向左计数。如果符合条件的元素个数小于len取值,则返回所有满足条件的元素。
返回值说明
返回输入 BITMAP 的子集。如果任何一个输入参数无效,则返回 NULL。