Math.clz32() 関数は、引数として与えられた数値の 32 ビットバイナリ表現での先頭の 0 の個数を返します。

構文

Math.clz32(x)

引数

x
数値。

返り値

与えられた数値の 32 ビットバイナリ表現での先頭の 0 の個数。

説明

"clz32" は CountLeadingZeroes32 の省略です。

x が数値でない場合、まず数値に変換され、32 ビット符号なし整数値に変換されます。

変換された 32 ビット符号なし整数値が 0 の場合、すべてのビットが 0 のため、32 を返します。

この関数は Emscripten のような JS にコンパイルするシステムに対して特に役に立ちます。

Math.clz32()を使う

Math.clz32(1);                // 31
Math.clz32(1000);             // 22
Math.clz32();                 // 32

[NaN, Infinity, -Infinity, 0, -0, null, undefined, 'foo', {}, []].filter(
function(n) {
  return Math.clz32(n) !== 32
});                           // []

Math.clz32(true);             // 31
Math.clz32(3.5);              // 30

ポリフィル

以下のポリフィルが最も効果的です。

if (!Math.clz32) {
  Math.clz32 = function(x) {
    // Let n be ToUint32(x).
    // Let p be the number of leading zero bits in 
    // the 32-bit binary representation of n.
    // Return p.    
    if (x == null || x === 0) {
      return 32;
    }
    return 31 - Math.floor(Math.log(x >>> 0) * Math.LOG2E);
  };
}

仕様

仕様 状況 コメント
ECMAScript 2015 (6th Edition, ECMA-262)
Math.clz32 の定義
標準 初回定義。
ECMAScript Latest Draft (ECMA-262)
Math.clz32 の定義
ドラフト  

ブラウザー実装状況

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

機能 Chrome Firefox (Gecko) Internet Explorer Opera Safari
基本サポート 38 31 (31) 未サポート 25 未サポート
機能 Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
基本サポート 未サポート 未サポート 31.0 (31) 未サポート 未サポート 未サポート

関連情報

ドキュメントのタグと貢献者

このページの貢献者: dskmori, shide55
最終更新者: dskmori,