ㅎ 한글스크립트0.8 문서

목록 함수

목록 기능의 입력·반환값·예제·원본 변경 여부. 기본 이름은 같은 파일의 최상위 선언에서 중복 정의하지 마세요. 타입 표기는 내부 TypeScript 서명이며 실행 예제는 문장형 HGS입니다.

목록

추가

기존 목록의 끝에 값을 추가합니다.

추가<T>(목록: T[], 값: T): void

원본 변경

값은 [1]이다
추가(값, 2)
출력(값)
실행 화면에서 열기 ↗

목록

범위

시작 이상·끝 미만의 숫자 목록을 만듭니다. 인자 하나면 0부터 시작합니다.

범위(시작: number, 끝?: number, 간격 = 1): number[]

간격 0·비유한 숫자·10만 개 초과는 오류

출력(범위(5, 0, -2))
실행 화면에서 열기 ↗

목록

목록으로

문자열·집합 등 순회 가능한 값을 배열로 바꿉니다.

목록으로<T>(값: Iterable<T>): T[]

새 배열. 문자열은 유니코드 코드 포인트 단위

출력(목록으로(집합([1, 2])))
실행 화면에서 열기 ↗

목록

첫번째

첫 항목을 읽습니다.

첫번째<T>(값: readonly T[]): T | undefined

빈 목록이면 정의안됨

출력(첫번째([10, 20]))
실행 화면에서 열기 ↗

목록

마지막

마지막 항목을 읽습니다.

마지막<T>(값: readonly T[]): T | undefined

빈 목록이면 정의안됨

출력(마지막([10, 20]))
실행 화면에서 열기 ↗

목록

꺼내기

지정 순서의 값을 읽습니다. 음수는 뒤에서 셉니다.

꺼내기<T>(값: readonly T[], 순서: number): T | undefined

삭제하지 않음. 범위 밖이면 정의안됨

출력(꺼내기([10, 20, 30], -1))
실행 화면에서 열기 ↗

목록

각각바꾸기

항목마다 함수를 적용해 새 목록을 만듭니다.

각각바꾸기<T, U>(값: readonly T[], 바꿀: (항목: T, 순서: number) => U): U[]

원본을 변경하지 않습니다.

출력(각각바꾸기([1, 2], 값 => 값 * 2))
실행 화면에서 열기 ↗

목록

골라내기

조건을 만족하는 항목만 남깁니다.

골라내기<T>(값: readonly T[], 조건: (항목: T, 순서: number) => boolean): T[]

원본을 변경하지 않습니다.

출력(골라내기([1, 2, 3], 값 => 값 >= 2))
실행 화면에서 열기 ↗

목록

찾기

조건을 만족하는 첫 항목을 찾습니다.

찾기<T>(값: readonly T[], 조건: (항목: T, 순서: number) => boolean): T | undefined

없으면 정의안됨

출력(찾기([1, 2, 3], 값 => 값 > 1))
실행 화면에서 열기 ↗

목록

순서찾기

조건을 만족하는 첫 항목의 0부터 시작하는 순서를 찾습니다.

순서찾기<T>(값: readonly T[], 조건: (항목: T, 순서: number) => boolean): number

없으면 -1

출력(순서찾기([1, 2, 3], 값 => 값 > 1))
실행 화면에서 열기 ↗

목록

모두만족

모든 항목이 조건을 만족하는지 확인합니다.

모두만족<T>(값: readonly T[], 조건: (항목: T) => boolean): boolean

빈 목록이면 참

출력(모두만족([2, 4], 값 => 값 % 2 === 0))
실행 화면에서 열기 ↗

목록

하나라도만족

하나 이상의 항목이 조건을 만족하는지 확인합니다.

하나라도만족<T>(값: readonly T[], 조건: (항목: T) => boolean): boolean

빈 목록이면 거짓

출력(하나라도만족([1, 2], 값 => 값 % 2 === 0))
실행 화면에서 열기 ↗

목록

누적하기

시작값부터 항목을 차례로 합쳐 하나의 값으로 만듭니다.

누적하기<T, U>(값: readonly T[], 시작: U, 합칠: (누적: U, 항목: T, 순서: number) => U): U

빈 목록이면 시작값

출력(누적하기([1, 2, 3], 0, (합, 값) => 합 + 값))
실행 화면에서 열기 ↗

목록

잘라내기

시작 이상·끝 미만의 구간을 새 목록으로 복사합니다.

잘라내기<T>(값: readonly T[], 시작: number, 끝?: number): T[]

원본 유지. 음수 순서 지원

출력(잘라내기([10, 20, 30], 1, 3))
실행 화면에서 열기 ↗

목록

이어붙이기

여러 목록을 이어 새 목록을 만듭니다.

이어붙이기<T>(...목록들: readonly (readonly T[])[]): T[]

원본을 변경하지 않습니다.

출력(이어붙이기([1, 2], [3]))
실행 화면에서 열기 ↗

목록

뒤집기

역순의 새 목록을 만듭니다.

뒤집기<T>(값: readonly T[]): T[]

원본 유지

출력(뒤집기([1, 2, 3]))
실행 화면에서 열기 ↗

목록

펼치기

한 단계 중첩된 목록을 펼칩니다.

펼치기<T>(값: readonly (readonly T[])[]): T[]

한 단계만 펼침. 재귀 평탄화 아님

출력(펼치기([[1, 2], [3]]))
실행 화면에서 열기 ↗

목록

나눠묶기

정해진 크기의 묶음들로 나눕니다.

나눠묶기<T>(값: readonly T[], 크기: number): T[][]

크기는 1 이상의 안전한 정수. 마지막 묶음은 짧을 수 있음

출력(나눠묶기([1, 2, 3, 4, 5], 2))
실행 화면에서 열기 ↗

목록

짝짓기

두 목록에서 같은 순서의 값끼리 짝을 만듭니다.

짝짓기<T, U>(가: readonly T[], 나: readonly U[]): [T, U][]

짧은 목록의 길이에 맞춤

출력(짝짓기([1, 2], ["가", "나"]))
실행 화면에서 열기 ↗