Update example

Author: devlights

examples/singleapp/utf8-byte-count/.gitignore

@@ -0,0 +1 @@
+*.txt

examples/singleapp/utf8-byte-count/Taskfile.yml

@@ -12,3 +12,12 @@ tasks:
   run-userune:
     cmds:
       - go run main.go -u
+  diff:
+    cmds:
+      - go run main.go > manual.txt
+      - go run main.go -u > userune.txt
+      - diff manual.txt userune.txt
+    ignore_error: true
+  clean:
+    cmds:
+      - rm -f ./*.txt

examples/singleapp/utf8-byte-count/main.go

@@ -21,25 +21,24 @@ func main() {
 func run(runeMode bool) error {
 	var (
 		strs = []string{
-			// 全角かな
+			// 全角かな (3bytes)
 			"こんにちは",
-			// 全角カタカナ
+			// 全角カタカナ (3bytes)
 			"コンニチハ",
-			// 半角カタカナ
-			"ｺﾝﾆﾁﾜ",
-			// 英数字
+			// 半角カタカナ (3bytes)
+			"ｺﾝﾆﾁﾊ",
+			// 英数字記号 (1byte)
 			"golang->60l4n6",
-			// ©¼½¾
+			// ©¼½¾ (2bytes)
 			"\U000000A9\U000000BC\U000000BD\U000000BE",
-			// 🍺🍻🍷🍜
+			// 🍺🍻🍷🍜 (4bytes)
 			"\U0001F37A\U0001F37B\U0001F377\U0001F35C",
 		}
 		fn = manual
 	)
 
 	if runeMode {
 		fn = userune
-		output.Stdoutl("[MODE]", "Use Rune")
 	}
 
 	for _, v := range strs {
@@ -61,20 +60,38 @@ func userune(s string) {
 			continue
 		}
 
-		output.Stdoutl("[byte-count]", utf8.RuneLen(r))
+		output.Stdoutf("[byte-count]", "%c (%d)\n", r, utf8.RuneLen(r))
 	}
 }
 
 func manual(s string) {
 	for i := 0; i < len(s); {
-		//
-		// UTF-8の先頭バイトを判定し、バイトサイズ算出
-		//
 		var (
 			b = s[i]
 			l = 0
 		)
 
+		//
+		// UTF-8の先頭バイトを判定し、バイトサイズ算出
+		//
+		// UTF-8エンコーディングでは、各文字は1バイトから4バイトまでの可変長でエンコードされる。
+		// 先頭バイト（最初のバイト）を見ることで、その文字が何バイトでエンコードされているかを判定できる。
+		//
+		// - 0xxxxxxx: 1バイト（ASCIIと互換性あり）
+		// - 110xxxxx: 続く1バイトと合わせて2バイト
+		// - 1110xxxx: 続く2バイトと合わせて3バイト
+		// - 11110xxx: 続く3バイトと合わせて4バイト
+		//
+		// 以下の case は上記を判定している.
+		//
+		// - (b & 0x80) == 0:    最上位ビットが0なら、この文字は1バイト
+		// - (b & 0xE0) == 0xC0: 最上位2ビットが110なら、この文字は2バイト
+		// - (b & 0xF0) == 0xE0: 最上位3ビットが1110なら、この文字は3バイト
+		// - (b & 0xF8) == 0xF0: 最上位4ビットが11110なら、この文字は4バイト
+		//
+		// REFERENCES:
+		//   - https://ja.wikipedia.org/wiki/UTF-8
+		//
 		switch {
 		case (b & 0x80) == 0:
 			l = 1
@@ -86,12 +103,15 @@ func manual(s string) {
 			l = 4
 		}
 
-		i += l
-		if b == ' ' {
-			output.StdoutHr()
-			continue
-		}
+		func() {
+			defer func() { i += l }()
+
+			if b == ' ' {
+				output.StdoutHr()
+				return
+			}
 
-		output.Stdoutl("[byte-count]", l)
+			output.Stdoutf("[byte-count]", "%s (%d)\n", s[i:i+l], l)
+		}()
 	}
 }