From e7d33b944dcbdd414ffa0673ff7f9db730cb6fc7 Mon Sep 17 00:00:00 2001
From: Tatsunori Uchino <tats.u@live.jp>
Date: Sun, 1 Feb 2026 21:51:52 +0900
Subject: [PATCH] Add comment

---
 src/java.base/share/classes/java/lang/CharSequence.java | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/java.base/share/classes/java/lang/CharSequence.java b/src/java.base/share/classes/java/lang/CharSequence.java
index 2656989a33d..0f124da43b2 100644
--- a/src/java.base/share/classes/java/lang/CharSequence.java
+++ b/src/java.base/share/classes/java/lang/CharSequence.java
@@ -266,6 +266,8 @@ public interface CharSequence {
 
         // i < lastIndex works properly even for an empty sequence
         // thank to the fact that the length/index type in Java is signed
+        // All we have to do here is to count the number of surrogate pairs.
+        // The first code unit of a surrogate pair is in [0, lastIndex).
         for (int i = 0; i < lastIndex;) {
             if (Character.isHighSurrogate(charAt(i++)) && Character.isLowSurrogate(charAt(i))) {
                 n--;