Skip to content

Commit

Permalink
[ko] TypedArray.prototype.toSorted() 신규 번역 외 (#22332)
Browse files Browse the repository at this point in the history
* [ko] TypedArray.prototype.toSorted() 신규 번역 외

- TypedArray.prototype.toSorted() 신규 번역
- Array.prototype.toSorted() 최신화

* Update files/ko/web/javascript/reference/global_objects/typedarray/tosorted/index.md

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* 리뷰사항 수정

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
  • Loading branch information
wisedog and github-actions[bot] authored Jul 30, 2024
1 parent 413a117 commit 4bf3307
Show file tree
Hide file tree
Showing 2 changed files with 71 additions and 21 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -2,39 +2,24 @@
title: Array.prototype.toSorted()
slug: Web/JavaScript/Reference/Global_Objects/Array/toSorted
l10n:
sourceCommit: a213cd90f4c97cb12befa38c3b2db193d9d286fc
sourceCommit: e46c58e6ed948e8c35c206762eb14a2e68616ed1
---

{{JSRef}}

{{jsxref("Array")}}**`toSorted()`** 메서드는 {{jsxref("Array/sort", "sort()")}}에 대응되는 [복사](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#copying_methods_and_mutating_methods) 메서드입니다. 이 메서드는 요소들을 오름차순으로 정렬한 새로운 배열을 반환합니다.
{{jsxref("Array")}} 인스턴스의 **`toSorted()`** 메서드는 {{jsxref("Array/sort", "sort()")}}에 대응되는 [복사](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#복사_메서드와_변경_메서드) 버전의 메서드입니다. 이 메서드는 요소들을 오름차순으로 정렬한 새로운 배열을 반환합니다.

## 구문

```js-nolint
// 함수 없이 사용
toSorted()
// 화살표 함수
toSorted((a, b) => { /* … */ })
// 비교 함수
toSorted(compareFn)
// 인라인 비교 함수
toSorted(function compareFn(a, b) { /* … */ })
```

### 매개변수

- `compareFn` {{optional_inline}}

- : 정렬 순서를 정의하는 함수를 지정합니다. 생략하면 배열 요소는 문자열로 변환되고 각 문자의 유니코드 포인트 값에 따라 정렬됩니다.

- `a`
- : 비교할 첫 번째 요소입니다.
- `b`
- : 비교할 두 번째 요소입니다.
- : 요소 순서를 결정하는 함수입니다. 생략하면 배열 요소는 문자열로 변환되고 각 문자의 유니코드 코드 포인트 값에 따라 정렬됩니다. 자세한 정보는 {{jsxref("Array/sort", "sort()")}}를 참고하시기 바랍니다.

### 반환 값

Expand All @@ -44,9 +29,9 @@ toSorted(function compareFn(a, b) { /* … */ })

`compareFn` 매개변수에 대해 더 알아보려면 {{jsxref("Array/sort", "sort()")}}를 참조하세요.

[희소 배열](/ko/docs/Web/JavaScript/Guide/Indexed_collections#sparse_arrays)에서 `toSorted()` 메서드는 빈 슬롯을 `undefined` 값으로 간주하고 반복합니다.
[희소 배열](/ko/docs/Web/JavaScript/Guide/Indexed_collections#희소_배열)에서 `toSorted()` 메서드는 빈 슬롯을 `undefined` 값으로 간주하고 순회합니다.

`toSorted()` 메서드는 [일반화](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#generic_array_methods)되어 있습니다. `this` 값이 `length` 속성과 정수 키 속성을 가지고 있다고 가정합니다.
`toSorted()` 메서드는 [범용](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#범용_배열_메서드) 메서드 입니다. `this` 값이 `length` 속성과 정수 키 속성을 가지고 있다고 가정합니다.

## 예제

Expand Down Expand Up @@ -85,6 +70,7 @@ const arrayLike = {
unrelated: "foo",
0: 5,
2: 4,
3: 3, // length가 3이기 때문에 toSorted()는 이를 무시합니다
};
console.log(Array.prototype.toSorted.call(arrayLike));
// [4, 5, undefined]
Expand All @@ -100,7 +86,8 @@ console.log(Array.prototype.toSorted.call(arrayLike));

## 같이 보기

- [Polyfill of `Array.prototype.toSorted` in `core-js`](https://github.com/zloirock/core-js#change-array-by-copy)
- [`core-js`에서의 `Array.prototype.toSorted` 폴리필](https://github.com/zloirock/core-js#change-array-by-copy)
- [인덱스 기반 컬렉션](/ko/docs/Web/JavaScript/Guide/Indexed_collections) 가이드
- {{jsxref("Array.prototype.sort()")}}
- {{jsxref("Array.prototype.toReversed()")}}
- {{jsxref("Array.prototype.toSpliced()")}}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
---
title: TypedArray.prototype.toSorted()
slug: Web/JavaScript/Reference/Global_Objects/TypedArray/toSorted
l10n:
sourceCommit: e46c58e6ed948e8c35c206762eb14a2e68616ed1
---

{{JSRef}}

{{jsxref("TypedArray")}} 인스턴스의 **`toSorted()`** 메서드는 {{jsxref("TypedArray/sort", "sort()")}} 메서드의 [복사](/ko/docs/Web/JavaScript/Reference/Global_Objects/Array#copying_methods_and_mutating_methods)버전입니다. 이 메서드는 오름차순으로 정렬된 요소를 가지는 새로운 형식화 배열을 반환합니다. 기본적으로는 문자열 대신 값을 산술적으로 정렬한다는 점 외에는 이 메서드는 {{jsxref("Array.prototype.toSorted()")}}와 같은 알고리즘을 가지고 있습니다.

## 구문

```js-nolint
toSorted()
toSorted(compareFn)
```

### 매개변수

- `compareFn` {{optional_inline}}

- : 요소 순서를 결정하는 함수입니다. 생략하면 배열 요소는 숫자 값에 따라 정렬됩니다. 자세한 정보는 {{jsxref("TypedArray/sort", "sort()")}}를 참고하시기 바랍니다.

### 반환 값

오름 차순으로 정렬된 요소가 있는 새로운 형식화 배열.

## 설명

자세한 정보는 {{jsxref("Array.prototype.toSorted()")}}을 참고하시기 바랍니다. 이 메서드는 범용 메서드가 아니며, 형식화 배열 인스턴스에서만 호출할 수 있습니다.

## 예제

### 배열 정렬하기

더 많은 예제는 {{jsxref("Array.prototype.sort()")}}를 참고하시기 바랍니다.

```js
const numbers = new Uint8Array([40, 1, 5, 200]);
const numberSorted = numbers.toSorted();
console.log(numberSorted); // Uint8Array [ 1, 5, 40, 200 ]
// 일반 배열과는 다르게, 숫자를 산술적으로 정렬하기 위해서
// 비교 함수가 필수는 아닙니다.
console.log(numbers); // Uint8Array [ 40, 1, 5, 200 ]
```

## 명세서

{{Specifications}}

## 브라우저 호환성

{{Compat}}

## 같이 보기

- [`core-js`에서의 `TypedArray.prototype.toSorted` 폴리필](https://github.com/zloirock/core-js#change-array-by-copy)
- [JavaScript 형식화 배열](/ko/docs/Web/JavaScript/Guide/Typed_arrays) 가이드
- {{jsxref("TypedArray.prototype.sort()")}}
- {{jsxref("TypedArray.prototype.toReversed()")}}
- {{jsxref("TypedArray.prototype.with()")}}
- {{jsxref("Array.prototype.toSorted()")}}

0 comments on commit 4bf3307

Please sign in to comment.