大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:COUNT_SUBSTRINGS

· 52CE 我爱测

COUNT_SUBSTRINGS 函数用于计算一个字符串中指定子串出现的次数。注意:当前实现在每次匹配到子串时,会偏移一个子串长度继续查找。例如,当 str='ccc' 且 pattern='cc' 时,返回结果为 1。

描述

COUNT_SUBSTRINGS 函数用于计算一个字符串中指定子串出现的次数。注意:当前实现在每次匹配到子串时,会偏移一个子串长度继续查找。例如,当 str='ccc' 且 pattern='cc' 时,返回结果为 1。

语法

COUNT_SUBSTRINGS(<str>, <pattern>[, <start_pos>])

参数

参数 说明
<str> 需要检测的字符串。类型:STRING
<pattern> 需要匹配的子串。类型:STRING
<start_pos> 开始搜索的位置(从1开始计数)。类型:INT。可选参数

返回值

返回 INT 类型,表示子串在字符串中出现的次数。

特殊情况:

  • 如果 str 为 NULL,返回 NULL
  • 如果 pattern 为空字符串,返回 0
  • 如果 str 为空字符串,返回 0
  • 如果 start_pos 小于等于0或超出字符串长度范围,返回 0
  • 如果 pattern 的长度大于 str(或从 start_pos 开始的剩余部分)的长度,返回 0

4.1.4 版本修复了字符串尾部的"越界匹配"问题:当剩余字符数已经不足以容纳一个完整的 pattern 时,旧版本可能仍然多计一次。例如 count_substrings('ab', 'abc') 旧版本可能返回 1,修复后正确返回 0;count_substrings('ccc', 'cc', 3) 修复后返回 0。

示例

  1. 基本用法
SELECT count_substrings('a1b1c1d', '1');
+----------------------------------+
| count_substrings('a1b1c1d', '1') |
+----------------------------------+
|                                3 |
+----------------------------------+
  1. 连续逗号的情况
SELECT count_substrings(',,a,b,c,', ',');
+-----------------------------------+
| count_substrings(',,a,b,c,', ',') |
+-----------------------------------+
|                                 5 |
+-----------------------------------+
  1. 重叠子串的情况
SELECT count_substrings('ccc', 'cc');
+--------------------------------+
| count_substrings('ccc', 'cc')  |
+--------------------------------+
|                              1 |
+--------------------------------+
  1. NULL 值处理
SELECT count_substrings(NULL, ',');
+-----------------------------+
| count_substrings(NULL, ',') |
+-----------------------------+
|                        NULL |
+-----------------------------+
  1. 空字符串处理
SELECT count_substrings('a,b,c,abcde', '');
+-------------------------------------+
| count_substrings('a,b,c,abcde', '') |
+-------------------------------------+
|                                   0 |
+-------------------------------------+
  1. 使用起始位置参数
SELECT count_substrings('ṭṛì ḍḍumai ṭṛì ti ḍḍumannàri', 'ḍḍu', 1), 
       count_substrings('ṭṛì ḍḍumai ṭṛì ti ḍḍumannàri', 'ḍḍu', 6);
+-----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+
| count_substrings('ṭṛì ḍḍumai ṭṛì ti ḍḍumannàri', 'ḍḍu', 1)                        | count_substrings('ṭṛì ḍḍumai ṭṛì ti ḍḍumannàri', 'ḍḍu', 6)                        |
+-----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+
|                                                                                 2 |                                                                                 1 |
+-----------------------------------------------------------------------------------+-----------------------------------------------------------------------------------+
  1. 起始位置超出范围
SELECT count_substrings('éèêëìíîïðñòó éèêëìíîïðñòó', 'éèê', 0), 
       count_substrings('éèêëìíîïðñòó éèêëìíîïðñòó', 'éèê', 30);
+------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
| count_substrings('éèêëìíîïðñòó éèêëìíîïðñòó', 'éèê', 0)                            | count_substrings('éèêëìíîïðñòó éèêëìíîïðñòó', 'éèê', 30)                            |
+------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+
|                                                                                  0 |                                                                                   0 |
+------------------------------------------------------------------------------------+-------------------------------------------------------------------------------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。