统计字数

函数名：wb_统计字数 / str_CountChar

功能描述

统计文本中各类字符的数量，支持分类统计汉字、字母、数字、空格和其他字符。可选择返回单类统计或全部统计明细。

会员等级：🟢 免费版（Free）

语法

=str_CountChar(文本, 统计类别)

参数

参数名	类型	必填	默认值	说明
文本	String	是	无	要统计的文本
统计类别	Int	否	0	1=汉字，2=字母，3=数字，4=空格，5=其他，0=全部

返回值

Object[,] - 统计结果。当 统计类别 为 1-5 时，返回 1x1 数组（单个数值）；当为 0（全部）时，返回 5 行 2 列的明细表格。

使用示例

统计全部字符明细

公式：

=str_CountChar("Hello 世界 2025", 0)

结果（5 行 2 列表格）：

汉字	2
字母	5
数字	4
空格	3
其他	0

仅统计汉字数量

公式：

=str_CountChar("Hello 世界 2025", 1)

结果：

2

仅统计数字数量

公式：

=str_CountChar("Hello 世界 2025", 3)

结果：

4

技术说明

• 逐字符遍历文本，按以下优先级分类统计：
  • 汉字：Unicode 码点在 0x4E00-0x9FFF 范围内（CJK 统一汉字基本区）
  • 字母：char.IsLetter 判定为 true 且非汉字的字符
  • 数字：char.IsDigit 判定为 true 的字符
  • 空格：char.IsWhiteSpace 判定为 true 的字符
  • 其他：以上类别均不满足的字符
• 统计类别 为 0 或其他值时，返回 5 行 2 列数组（第一列为类别名，第二列为数量）
• 统计类别 为 1-5 时，返回对应类别的单个数值（1x1 数组）

错误处理

错误场景	返回值
文本为空或 null	#N/A（ExcelError.ExcelErrorNA）
处理过程中发生异常	#VALUE!（ExcelError.ExcelErrorValue）