v2 새로운 구조로 변경

README.md

@@ -13,10 +13,11 @@ Usage
 The return value is the *Hangul Compatibility Jamo* between `U+3130` and `U+318F`  
 반환 값은 `U+3130`와 `U+318F` 사이의 *Hangul Compatibility Jamo*가 반환 됩니다. 
 - See [Hangul Compatibility Jamo](https://unicode.org/charts/PDF/U3130.pdf)
+
 ```php
-use AcidF0x\KoreanHandler\Separator; 
+use AcidF0x\KoreanHandler\aaaaaaa; 
 
-$separator = new Separator();
+$separator = new aaaaaaa();
 
 $separator->separate("가");
 $separator->getChoseong(); //  "ㄱ" 
@@ -36,9 +37,9 @@ The return value is the *Hangul Jamo* between `U+1100` and `U+11FF`
 - See [Hangul Jamo](https://unicode.org/charts/PDF/U1100.pdf)
 
 ```php
-use AcidF0x\KoreanHandler\Separator; 
+use AcidF0x\KoreanHandler\aaaaaaa; 
 
-$separator = new Separator();
+$separator = new aaaaaaa();
 $separator->strictMode();
 
 $separator->separate("가");

composer.json

@@ -16,7 +16,7 @@
     },
     "require": {
         "php": ">=7.4",
-	"ext-mbstring": "*"
+	    "ext-mbstring": "*"
     },
     "require-dev": {
         "phpunit/phpunit": "^9.0"

src/Character.php

@@ -0,0 +1,75 @@
+<?php
+
+namespace AcidF0x\KoreanHandler;
+
+class Character
+{
+    private ?string $choseong = null;
+    private ?string $jungseong = null;
+    private ?string $jongseong = null;
+    /** @var array|string[] */
+    private array $split = [];
+
+    public function __construct(?string $choseong, ?string $jungseong, ?string $jongseong)
+    {
+        $this->choseong = $choseong;
+        $this->jungseong = $jungseong;
+        $this->jongseong = $jongseong;
+    }
+
+    public function getChoseong(): ?string
+    {
+        return $this->choseong;
+    }
+
+    public function setChoseong(?string $choseong): Character
+    {
+        $this->choseong = $choseong;
+        return $this;
+    }
+
+    public function getJungseong(): ?string
+    {
+        return $this->jungseong;
+    }
+
+    public function setJungseong(?string $jungseong): Character
+    {
+        $this->jungseong = $jungseong;
+        return $this;
+    }
+
+    public function getJongseong(): ?string
+    {
+        return $this->jongseong;
+    }
+
+    public function setJongseong(?string $jongseong): Character
+    {
+        $this->jongseong = $jongseong;
+        return $this;
+    }
+
+    /**
+     * @return array|string[]
+     */
+    public function getSplit(): array
+    {
+        return $this->split;
+    }
+
+    public function setSplit(): Character
+    {
+        $split = [
+            $this->choseong,
+            $this->jungseong
+        ];
+
+        if ($this->jongseong) {
+            $split[] = $this->jongseong;
+        }
+
+        $this->split = $split;
+        return $this;
+    }
+}

src/Constants.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace AcidF0x\KoreanHandler;
+
+final class Constants
+{
+    /** @var int 한글 음절 첫글자 = 가 */
+    public const UNICODE_HANGUL_SYLLABLE_START = 44032;
+    /** @var int 한글 음절 마지막 글자 = 힣 */
+    public const UNICODE_HANGUL_SYLLABLE_END = 55203;
+    /** @var string[] 초성리스트 */
+    public const CHOSEONG_LIST = ["ㄱ","ㄲ","ㄴ","ㄷ","ㄸ","ㄹ","ㅁ","ㅂ","ㅃ","ㅅ","ㅆ","ㅇ","ㅈ","ㅉ","ㅊ","ㅋ","ㅌ","ㅍ","ㅎ"];
+    /** @var string[] 중성리스트 */
+    const JUNGSEONG_LIST = ["ㅏ","ㅐ","ㅑ","ㅒ","ㅓ","ㅔ","ㅕ","ㅖ","ㅗ","ㅘ","ㅙ","ㅚ","ㅛ","ㅜ","ㅝ","ㅞ","ㅟ","ㅠ","ㅡ","ㅢ","ㅣ"];
+    /** @var string[] 종성리스트 */
+    const JONGSEONG_LIST = ["ㄱ","ㄲ","ㄳ","ㄴ","ㄵ","ㄶ","ㄷ","ㄹ","ㄺ","ㄻ","ㄼ","ㄽ","ㄾ","ㄿ","ㅀ","ㅁ","ㅂ","ㅄ","ㅅ","ㅆ","ㅇ","ㅈ","ㅊ","ㅋ","ㅌ","ㅍ","ㅎ"];
+}

src/SeparateResult.php

@@ -0,0 +1,96 @@
+<?php
+
+namespace AcidF0x\KoreanHandler;
+
+use ArrayAccess;
+use Iterator;
+
+class SeparateResult implements ArrayAccess, Iterator
+{
+    private int $position;
+    /** @var array|Character */
+    private array $characters = [];
+
+    public function __construct(array $characters = [])
+    {
+        $this->position = 0;
+        $this->characters = $characters;
+    }
+
+    public function offsetSet($offset, $value) {
+        if (is_null($offset)) {
+            $this->characters[] = $value;
+        } else {
+            $this->characters[$offset] = $value;
+        }
+    }
+
+    public function offsetExists($offset): bool
+    {
+        return isset($this->characters[$offset]);
+    }
+
+    public function offsetUnset($offset)
+    {
+        unset($this->characters[$offset]);
+    }
+
+    public function offsetGet($offset): ?Character
+    {
+        return $this->characters[$offset] ?? null;
+    }
+
+    public function rewind()
+    {
+        $this->position = 0;
+    }
+
+    public function current(): Character
+    {
+        return $this->characters[$this->position];
+    }
+
+    public function key(): int
+    {
+        return $this->position;
+    }
+
+    public function next()
+    {
+        ++$this->position;
+    }
+
+    public function valid(): bool
+    {
+        return isset($this->characters[$this->position]);
+    }
+
+    public function getChoseongList(): array
+    {
+        return array_map(fn(Character $char) => $char->getChoseong(), $this->characters);
+    }
+
+    public function getJungseongList(): array
+    {
+        return array_map(fn(Character $char) => $char->getJungseong(), $this->characters);
+    }
+
+    public function getJongseongList(): array
+    {
+        return array_filter(
+            array_map(fn(Character $char) => $char->getJongseong(), $this->characters),
+            fn($i) => $i !== null
+        );
+    }
+
+    public function getSplitList(): array
+    {
+        $result = [];
+        /** @var Character $character */
+        foreach ($this->characters as $character) {
+            array_push($result, ...$character->getSplit());
+        }
+
+        return $result;
+    }
+}