Java StringBuilder 中怎么通过 codePointCount 精准统计实际的字符物理个数

千杰君_5401

千杰君_5401

2026-08-02

181人浏览

原创

stringbuilder 的 codepointcount(int beginindex, int endindex) 方法统计指定范围内 unicode 码点数,正确处理代理对,而 length() 仅返回 char 数组长度,对 emoji 等补充字符会高估;调用时需满足 0 ≤ beginindex ≤ endindex ≤ length(),推荐用 sb.codepointcount(0, sb.length()) 获取真实字符数。

java stringbuilder 中怎么通过 codepointcount 精准统计实际的字符物理个数

Java 中 StringBuilder 的 codePointCount(int beginIndex, int endIndex) 方法,是用来统计指定范围内 **Unicode 码点(code point)的个数**,而非 char 数组长度。它能正确处理 Unicode 补充字符(即需要两个 char 表示的代理对,surrogate pair),从而得到人眼可见的“真实字符数”。

为什么不能直接用 length()?

length() 返回的是内部 char 数组的长度,而一个 emoji 或古汉字(如 ?、?)可能占用 2 个 char(即一个代理对),但只算作 1 个逻辑字符(1 个码点)。此时 length() 会高估,codePointCount() 才准确。

如何正确调用 codePointCount

该方法签名是:int codePointCount(int beginIndex, int endIndex),注意:

JavaStoryDevelop
JavaStoryDevelop

你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在

下载
  • 索引范围是左闭右开:包含 beginIndex,不包含 endIndex
  • 两个索引必须满足 0 ≤ beginIndex ≤ endIndex ≤ length()
  • 底层会自动识别并跳过代理对,把每个完整码点计为 1

典型使用示例

比如构建含 emoji 和中文的字符串:

StringBuilder sb = new StringBuilder("a\uD83D\uDC31b"); // "a" + ? + "b"
System.out.println(sb.length());           // 输出 4('a' + 高代理 + 低代理 + 'b')
System.out.println(sb.codePointCount(0, sb.length())); // 输出 3(a、?、b 各 1 个码点)

再比如统计前 2 个码点:

  • sb.codePointCount(0, 2) → 若前两个码点是 "a" 和 ?,结果为 2
  • 注意:不能传 sb.codePointCount(0, 3) 来“取前 3 个 char”,因为 endIndex=3 可能切在代理对中间,抛 IndexOutOfBoundsException

安全获取全部码点数的推荐写法

要统计整个 StringBuilder 的真实字符数,统一用:

  • sb.codePointCount(0, sb.length()) —— 最稳妥
  • 避免手动计算或遍历 codePointAt(),除非需逐个处理码点
  • 若需遍历所有码点,用 for (int i = 0; i

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

11017

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

8122

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7032

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1184

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

968

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1436

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2909

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20191

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1275

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习