【JSリファレンス】BigInt64Array.prototype.toSorted()

更新日：2024/06/14

初出：ECMAScript2023


BigInt64Array.prototype.toSorted()は、BigInt64Arrayオブジェクト(BigInt64Arrayコンストラクターのインスタンス)のプロトタイプチェーンに組み込まれるメソッドです。

BigInt64Arrayオブジェクト内で要素を昇順に並び替えますが、コールバック関数によるカスタマイズも可能です
並び替えた結果は、新しいArrayBufferが関連付けられた、新しいBigInt64Arrayオブジェクトにセットされます。

同様の機能にBigInt64Array.prototype.sort()がありますが、こちらは元となるBigInt64Arrayオブジェクトの内容を変更します。

 

■構文


BigInt64Array.prototype.toSorted ( comparefn )
  1. comparefn: 省略可能。
    要素の比較を行う関数を指定する。
生成されたBigInt64Arrayオブジェクト

 

■comparefnの構文


comparefn ( x , y ){  }
  1. x: 現在比較対象となっている要素の値
  2. y: 現在比較対象となっている要素の値
x と y の大小関係を、次の表に従って返す

■戻り値とxとyの関係
大小関係戻り値
y の方が大きい( x < y ) 負の値
x の方が大きい( x < y ) 正の値
同じ値( x = y )0

※戻り値はNumber型です。
x と y はBigInt型のため、Number型に変換して返します。

comparefnの省略時は、抽象比較 x < y が true なら -1、x > y が true なら 1、それ以外なら 0 をcomparefnが返したとみなす。

 

■使用例

▶ x - y の結果を返すと昇順ソート

const typedArray = new BigInt64Array([8n,2n,11n]);
  
const typedArray2 = typedArray.toSorted( 
    (x,y) => Number(x - y)
 );

console.log( typedArray );  // [ 8n, 2n, 11n ]
console.log( typedArray2 ); // [ 2n, 8n, 11n ]

▶ (x - y) * -1 の結果を返すと降順ソート

const typedArray = new BigInt64Array([8n,2n,11n]);
  
const typedArray2 = typedArray.toSorted( 
    (x,y) => Number(x - y) * -1 // (x,y) => Number(y - x) でもOK
 );

console.log( typedArray );  // [ 8n, 2n, 11n ]
console.log( typedArray2 ); // [ 11n, 8n, 2n ]

更新日：2024/06/14

書いた人（管理人）：けーちゃん

スポンサーリンク

記事の内容について

null

こんにちはけーちゃんです。
説明するのって難しいですね。

「なんか言ってることおかしくない？」
たぶん、こんなご意見あると思います。

裏付けを取りながら記事を作成していますが、僕の勘違いだったり、そもそも情報源の内容が間違えていたりで、正確でないことが多いと思います。
そんなときは、ご意見もらえたら嬉しいです。

掲載コードについては事前に動作確認をしていますが、貼り付け後に体裁を整えるなどをした結果動作しないものになっていることがあります。
生暖かい視線でスルーするか、ご指摘ください。

ご意見、ご指摘はこちら。
https://jsref.affi-sapo-sv.com/info.php

 

このサイトは、リンクフリーです。大歓迎です。