Merge pull request #200 from myoshi2891/dev-from-macmini

Dev from macmini

Author: myoshi2891

Algorithm/TwoPointers/leetcode/67. Add Binary/Claude/README.md

@@ -19,12 +19,14 @@
 **問題**: 2つの2進数文字列 `a` と `b` が与えられたとき、それらの和を2進数文字列として返す。
 
 **要件**:
+
 - 入力は `'0'` と `'1'` のみで構成される
 - 長さは 1 ≤ len(a), len(b) ≤ 10⁴
 - 先頭ゼロは存在しない（`"0"` 自体を除く）
 - 出力も2進数文字列として正しい形式（先頭ゼロなし）
 
 **制約**:
+
 - 文字列長が最大1万桁なので、整数変換（`int(a, 2)`）は可能だが非効率
 - メモリ効率と実行速度の両立が求められる
 
@@ -35,22 +37,25 @@
 **戦略**: Two-Pointer + Carry（桁上がり）を用いた末尾からの1パス走査
 
 **データ構造**:
+
 - 入力を `bytes` に変換（`encode('ascii')`）してビット取得を高速化
 - 出力用に固定長 `bytearray` を確保し、末尾から直接ASCII文字を書き込み
 
 **計算量**:
+
 - **時間**: O(max(len(a), len(b))) = O(n)
 - **空間**: O(1) 補助空間（出力バッファを除く）
 
 **メモリ最適化**:
+
 - `reverse()` や `insert(0, ...)` などの高コスト操作を回避
 - 文字列の逐次結合（`+=`）を避け、最後に一度だけ `decode('ascii')`
 
 ---
 
 <h2 id="figures">図解</h2>
 
-### フローチャート
+## フローチャート
 
 ```mermaid
 flowchart TD
@@ -70,6 +75,7 @@ flowchart TD
 ```
 
 **説明**:
+
 - 早期チェックで一方が `"0"` の場合は他方をそのまま返す
 - 文字列を `bytes` に変換して各反復での `ord()` 呼び出しを排除
 - 末尾（最下位桁）から順に加算とキャリーを処理
@@ -97,6 +103,7 @@ graph LR
 ```
 
 **説明**:
+
 - 入力文字列を `bytes` に変換してビット取得を高速化
 - Two-Pointerで末尾から走査し、各桁の和とキャリーを計算
 - `bytearray` への直接書き込みでメモリ効率を最大化
@@ -107,18 +114,22 @@ graph LR
 <h2 id="correctness">正しさのスケッチ</h2>
 
 **不変条件**:
+
 - 各反復で、位置 `i`, `j`, `k` に対して `k` 位置に正しい桁の結果が書き込まれる
 - `carry` は常に 0 または 1 の値を持つ（2進数の桁上がりは最大1）
 
 **網羅性**:
+
 - `while i >= 0 or j >= 0 or carry` により、すべての桁とキャリーを処理
 - 短い方の文字列が終わっても、長い方とキャリーの処理を続行
 
 **基底条件**:
+
 - `i < 0` かつ `j < 0` かつ `carry == 0` で終了
 - 最上位桁のキャリーも `bytearray` に書き込まれる
 
 **終了性**:
+
 - 各反復で `i`, `j`, `k` が減少
 - 有限長の入力に対して必ず終了
 
@@ -127,6 +138,7 @@ graph LR
 <h2 id="complexity">計算量</h2>
 
 ### 時間計算量
+
 **O(n)** ここで n = max(len(a), len(b))
 
 - `encode('ascii')`: O(len(a)) + O(len(b))
@@ -135,6 +147,7 @@ graph LR
 - `decode('ascii')`: O(n)
 
 ### 空間計算量
+
 **O(1) 補助空間**（出力バッファを除く）
 
 - `a_bytes`, `b_bytes`: 入力サイズに比例（O(n)）だが、入力として必要
@@ -143,11 +156,11 @@ graph LR
 
 ### アプローチ比較
 
-| アプローチ | 時間 | 空間 | 特徴 |
-|---------|-----|-----|-----|
-| **Two-Pointer + bytearray（採用）** | O(n) | O(1) | 最速、メモリ効率最高 |
-| list.append + reverse + join | O(n) | O(n) | 実装簡単だが中間配列必要 |
-| int変換 + bin() | O(n) | O(n) | 大きい数で非効率、多倍長演算 |
+| アプローチ                          | 時間 | 空間 | 特徴                         |
+| ----------------------------------- | ---- | ---- | ---------------------------- |
+| **Two-Pointer + bytearray（採用）** | O(n) | O(1) | 最速、メモリ効率最高         |
+| list.append + reverse + join        | O(n) | O(n) | 実装簡単だが中間配列必要     |
+| int変換 + bin()                     | O(n) | O(n) | 大きい数で非効率、多倍長演算 |
 
 ---
 
@@ -224,6 +237,7 @@ class Solution:
 ```
 
 **実装のポイント**:
+
 - `encode('ascii')` で文字列を `bytes` に変換し、各反復での `ord()` を排除
 - `& 1` でビット取得（'0'=48→0, '1'=49→1）
 - `bytearray` への直接書き込みで中間文字列生成を回避
@@ -234,6 +248,7 @@ class Solution:
 <h2 id="cpython">CPython最適化ポイント</h2>
 
 ### 1. `bytes` 変換による `ord()` 排除
+
 ```python
 # 遅い: 各反復で ord() を呼び出し
 bit = ord(a[i]) - ord('0')
@@ -244,6 +259,7 @@ bit = a_bytes[i] & 1
 ```
 
 ### 2. 固定長 `bytearray` への直接書き込み
+
 ```python
 # 遅い: リスト append + reverse + join
 result = []
@@ -258,19 +274,22 @@ return out[start:].decode('ascii')
 ```
 
 ### 3. 分岐の最小化
+
 ```python
 # 条件式でビット取得を統一
 ai = (a_bytes[i] & 1) if i >= 0 else 0
 bj = (b_bytes[j] & 1) if j >= 0 else 0
 ```
 
 ### 4. 定数のローカル化
+
 ```python
 ZERO: Final[int] = 48  # グローバル参照を避ける
 out[k] = ZERO + (s & 1)
 ```
 
 ### パフォーマンス結果
+
 - **Runtime**: 0ms（100.00%）
 - **Memory**: 17.92MB（28.60%）
 
@@ -281,21 +300,24 @@ out[k] = ZERO + (s & 1)
 <h2 id="edgecases">エッジケースと検証観点</h2>
 
 ### 境界値
-| ケース | 入力 | 期待出力 | 検証ポイント |
-|-------|-----|---------|------------|
-| 両方最小 | `a="0"`, `b="0"` | `"0"` | 早期リターン |
-| 片方最小 | `a="0"`, `b="1"` | `"1"` | 早期リターン |
-| 最小桁 | `a="1"`, `b="1"` | `"10"` | キャリー発生 |
-| キャリー連鎖 | `a="1111"`, `b="1"` | `"10000"` | 全桁キャリー |
-| 長さ差大 | `a="1"`, `b="1010101"` | `"1010110"` | 短い方の処理 |
-| 最大長 | len(a)=10⁴, len(b)=10⁴ | 正しい和 | パフォーマンス |
+
+| ケース       | 入力                   | 期待出力    | 検証ポイント   |
+| ------------ | ---------------------- | ----------- | -------------- |
+| 両方最小     | `a="0"`, `b="0"`       | `"0"`       | 早期リターン   |
+| 片方最小     | `a="0"`, `b="1"`       | `"1"`       | 早期リターン   |
+| 最小桁       | `a="1"`, `b="1"`       | `"10"`      | キャリー発生   |
+| キャリー連鎖 | `a="1111"`, `b="1"`    | `"10000"`   | 全桁キャリー   |
+| 長さ差大     | `a="1"`, `b="1010101"` | `"1010110"` | 短い方の処理   |
+| 最大長       | len(a)=10⁴, len(b)=10⁴ | 正しい和    | パフォーマンス |
 
 ### 特殊ケース
+
 - **キャリーのみ残る**: `a="1"`, `b="1"` → `"10"`
 - **一方が極端に短い**: `a="1"`, `b="1"*10000`
 - **交互のビットパターン**: `a="1010"`, `b="0101"` → `"1111"`
 
 ### 型安全性
+
 - 入力は必ず `str` 型（LeetCodeの制約保証）
 - 内部は `bytes` と `int` のみで処理
 - pylance で型エラーなし
@@ -307,6 +329,7 @@ out[k] = ZERO + (s & 1)
 ### Q1: なぜ `int(a, 2) + int(b, 2)` を使わないのか？
 
 **A**: 文字列長が最大10⁴桁の場合、整数変換は以下の問題がある:
+
 - 多倍長演算のオーバーヘッド
 - メモリ使用量の増加（大きな整数オブジェクト）
 - `bin()` での文字列化コスト
@@ -320,6 +343,7 @@ Two-Pointer方式は O(n) の線形時間で、メモリも最小限。
 ### Q3: なぜ `bytearray` を使うのか？
 
 **A**:
+
 - ミュータブルなバイト列で、固定長バッファとして使用可能
 - ASCII文字（数値）の直接書き込みが可能
 - `reverse()` や文字列結合のコストを回避
@@ -328,6 +352,7 @@ Two-Pointer方式は O(n) の線形時間で、メモリも最小限。
 ### Q4: 入力検証は必要か？
 
 **A**: LeetCodeの制約は保証されているため、本実装では省略。業務コードでは以下を検証:
+
 - 型チェック（`isinstance(a, str)`）
 - 長さチェック（1 ≤ len ≤ 10⁴）
 - 文字チェック（'0'/'1'のみ）
@@ -340,6 +365,7 @@ Two-Pointer方式は O(n) の線形時間で、メモリも最小限。
 ### Q6: より速くする方法は？
 
 **A**:
+
 - 入力検証を完全に削除（LeetCodeでは不要）
 - ローカル変数への関数バインド（`append = list.append`）
 - ただし、現在の実装で既に 0ms（100%）を達成しており、これ以上の改善は環境依存