https://github.com/jjangga0214/dart-cp949
Decode or encode CP949 (EUC-KR inclusive) in Dart.
https://github.com/jjangga0214/dart-cp949
character-set character-set-encodings character-sets charset cp949 dart dart-library dart-package encoding euc-kr euckr flutter ko korea korean korean-letters unicode
Last synced: about 2 months ago
JSON representation
Decode or encode CP949 (EUC-KR inclusive) in Dart.
- Host: GitHub
- URL: https://github.com/jjangga0214/dart-cp949
- Owner: jjangga0214
- License: mit
- Created: 2020-11-03T09:35:13.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-06-04T16:34:07.000Z (almost 4 years ago)
- Last Synced: 2025-03-25T08:51:25.423Z (2 months ago)
- Topics: character-set, character-set-encodings, character-sets, charset, cp949, dart, dart-library, dart-package, encoding, euc-kr, euckr, flutter, ko, korea, korean, korean-letters, unicode
- Language: Dart
- Homepage: https://pub.dev/packages/cp949
- Size: 638 KB
- Stars: 12
- Watchers: 1
- Forks: 13
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# dart-cp949
CP949 을 Encode, Decode 해 주는 라이브러리입니다.
(CP949 는 EUC-KR 의 상위집합이기 때문에, EUC-KR 도 다룰 수 있습니다.)
[](https://pub.dev/packages/cp949)
[](./LICENSE)
[](https://conventionalcommits.org)
[](http://commitizen.github.io/cz-cli/)
## Installation
```yaml
dependencies:
cp949: ^1.2.1
```
## Why?
Dart 는 non-unicode 인코딩/디코딩을 native 하게 지원하지 않습니다.
글을 쓰는 시점으로 CP949 지원하는 라이브러리는 이 프로젝트가 유일해 보입니다.
## Usage
### `decode(List codeUnits) -> String`
CP949 (EUC-KR) byte 배열을 (`List`) 받아 dart 의 native String 을 리턴합니다.
```dart
import 'package:cp949/cp949.dart' as cp949;
const cp949CodeUnitBytes = [0xBE, 0xC6, 0xB8, 0xA7, 0xB4, 0xD9, 0xbf, 0xee];
final decoded = cp949.decode(cp949CodeUnitBytes)); // '아름다운'
const brokenString = 'ÄÁÅÙÃ÷';
final decoded = cp949.decode(brokenString.codeUnits); // '컨텐츠'
```
### `decodeString(String brokenString) -> String`
CP949 (EUC-KR) byte 배열을 유니코드 기반으로 잘못 해석하여 깨져 보이는 String 을 받아 변환해 제대로 리턴합니다.
(dart 에서 깨져 보이는 것 뿐이지, 실 데이터 유실은 없습니다.)
```dart
import 'package:cp949/cp949.dart' as cp949;
const brokenString = 'ÄÁÅÙÃ÷';
final decoded = cp949.decodeString(brokenString); // '컨텐츠'
```
### `encode(String string) -> List`
dart 의 native String 을 받아 CP949 (EUC-KR) byte 배열로 (`List`) 리턴합니다.
```dart
import 'package:cp949/cp949.dart' as cp949;
final encoded = cp949.encode('아름다운'); // [0xBE, 0xC6, 0xB8, 0xA7, 0xB4, 0xD9, 0xBF, 0xEE]
final encoded = String.fromCharCodes(cp949.encode('컨텐츠')); // 'ÄÁÅÙÃ÷' (제대로 된 결과입니다!)
```
### `encodeToString(String string) -> String`
CP949 (EUC-KR) byte 배열을 유니코드 기반으로 잘못 해석하여 깨져 보이는 String 을 리턴합니다.
(dart 에서만 깨져보이는 것이지, 제대로 인코딩 된 것이므로, CP949 (EUC-KR) 을 처리할 수 있는 다른 프로그램으로 보낼 시 (REST API 등) 호환됩니다.)
```dart
import 'package:cp949/cp949.dart' as cp949;
final encoded = cp949.encodeToString('컨텐츠'); // 'ÄÁÅÙÃ÷' (제대로 된 결과입니다!)
```
## Examples
EUC-KR 로 인코딩된 http 응답을 받아오는 예시를 들면 다음과 같습니다.
```dart
import 'package:http/http.dart' as http;
import 'package:cp949/cp949.dart' as cp949;
const url = 'https://euc-kr-encoded-website.co.kr';
final response = await http.get(url);
print(cp949.decode(response.bodyBytes));
// 또는 print(cp949.decode(response.body.codeUnits));
// 또는 print(cp949.decodeString(response.body));
```
EUC-KR 인코딩을 사용하는 REST API 를 사용하는 예시를 들면 다음과 같습니다.
```dart
import 'package:http/http.dart' as http;
import 'package:cp949/cp949.dart' as cp949;
const url = 'https://euc-kr-accepting-api.co.kr';
await http.post(url,
body: {'title': cp949.encodeToString('컨텐츠'), 'foo': 'bar'});
```
## Development (Contribution)
이 project 는 마크다운 린트, 커밋 메세지 린트 등 개발환경 설정을 위해 yarn과 nodejs package 들을 사용합니다.
```shell
yarn install
yarn test
yarn format:md .
yarn format .
```
## License
[MIT License](LICENSE). Copyright © 2020, GIL B. Chan <[[email protected]](mailto:[email protected])>