# HML 1.0 표준 라이브러리

표준 모듈은 실행기에 포함됩니다. 아래처럼 `use`로 별칭을 정하고 `별칭::함수(인수)`로 호출합니다.

```text
use "std:text" := text
show(text::contains("Hello, HML", "HML"))
```

| 모듈 | 제공 기능 |
|---|---|
| `std:cli` | `args()`는 스크립트 뒤의 명령줄 인수 목록, `cwd()`는 실행한 폴더의 경로입니다. `exit(상태)`는 0~255 사이의 정수 상태로 종료합니다. |
| `std:fs` | `join(기준, 상대경로)`로 경로를 연결합니다. `list(폴더)`는 바로 아래 항목의 이름을 정렬해 반환합니다. `exists(경로)`, `is_file(경로)`, `is_dir(경로)`는 해당 상태를 확인하고, `mkdir(경로)`는 필요한 상위 폴더까지 만듭니다. |
| `std:text` | `read(경로)`와 `write(경로, 내용)`은 UTF-8 파일을 다룹니다. `trim(s)`, `split(s[, 구분자])`, `join(목록, 구분자)`, `lower(s)`, `upper(s)`, `contains(s, 부분)`, `starts(s, 시작)`, `ends(s, 끝)`, `replace(s, 기존, 새값)`을 제공합니다. |
| `std:csv` | `parse(문자열[, 구분자])`는 CSV를 문자열 행의 목록으로 읽습니다. `format(행목록[, 구분자])`는 문자열로 변환합니다. 기본 구분자는 쉼표이며 따옴표 안의 구분자와 줄바꿈을 지원합니다. |
| `std:json` | `load(경로[, 기본값])`, `save(경로, 값)`은 파일을 읽고 씁니다. `parse(문자열)`, `format(값)`은 JSON 문자열과 HML 값을 변환합니다. |
| `std:list` | `contains(목록, 값)`은 HML의 비교 규칙으로 항목을 찾습니다. `reverse(목록)`는 역순의 새 목록을 만듭니다. |
| `std:map` | `keys(맵)`, `values(맵)`는 저장 순서대로 키와 값을 반환합니다. `get(맵, 키, 기본값)`은 키가 없으면 기본값을 반환합니다. |
| `std:time` | `utc()`는 ISO 8601 UTC 문자열, `epoch()`는 유닉스 시각의 정수 초를 반환합니다. |
| `std:math` | `abs(x)`, `floor(x)`, `ceil(x)`, `sqrt(x)`, `round(x[, 자리수])`, 상수 `pi`를 제공합니다. |
| `std:stats` | `total(숫자목록)`과 `mean(숫자목록)`을 제공합니다. 두 함수는 HML로 작성됐습니다. |

대괄호로 감싼 인수는 생략할 수 있습니다. 파일 함수의 상대 경로는 함수를 호출한 `.hml` 파일의 폴더에서 시작합니다. 명령을 실행한 폴더를 기준으로 처리하려면 `cli::cwd()`를 사용합니다. 파일을 쓰는 함수는 지정된 대상 파일을 교체합니다.

`std:text`의 `fill(문자열, 맵)`은 `{키}`를 맵에 저장된 값의 출력 형태로 바꿉니다. 예를 들어 `text::fill("점수는 {점수}점", {"점수" := 95})`는 `점수는 95점`을 반환합니다. 중괄호 자체는 `{{`와 `}}`로 씁니다. 맵에 키가 없으면 `E_KEY`, 중괄호가 올바르지 않으면 `E_ARGUMENT`가 발생합니다.

## 예제 프로그램 실행

HML 명령이 등록된 환경에서는 `hml examples/find_text.hml 검색어`를 실행합니다. 압축에서 바로 실행할 때는 배포본의 README에 나온 실행 파일을 사용합니다. 프로그램은 현재 폴더 바로 아래의 `.txt` 파일을 검색하고, 일치한 파일 이름을 `hml-search.csv`에 기록합니다. 이미 같은 이름의 보고서가 있으면 새 결과로 교체합니다.
