-
Notifications
You must be signed in to change notification settings - Fork 38
Expand file tree
/
Copy pathBigInt.html
More file actions
46 lines (44 loc) · 8.77 KB
/
Copy pathBigInt.html
File metadata and controls
46 lines (44 loc) · 8.77 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
<!DOCTYPE html><html><head><meta charset="utf-8"><title>BigInt JavaScript API</title><meta name="description" content="Interactive API reference for the JavaScript BigInt Object. An arbitrarily large integer value. Allows storing integers larger than what Number allows. Use Number(bigInt) to convert a BigInt to a Num"><link rel="stylesheet" type="text/css" href="styles.css"><script type="text/javascript">var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-23450559-1']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
})();</script></head><body><script>if (sessionStorage.collapsed === 'true') {
document.body.classList.add('members-collapsed');
}
if (localStorage.theme) {
document.body.parentElement.classList.add(localStorage.theme);
}</script><div class="topnav"><a href="/">JavaScripture</a><div class="bookmarks"><a class="bookmark contribute" href="https://github.com/nkronlage/JavaScripture">Contribute via GitHub</a> <a class="bookmark" href="/feedback">Feedback</a></div></div><div class="container"><nav class="leftnav"><div id="searchContainer"><input id="searchBox" type="text" placeholder="Search (Ctrl + S)" autocomplete="false"><div id="resultsBox" style="display:none;"></div></div><div id="apichooser"><a href="#" onclick="openApiChooser(); return false;"><div class="arrow"></div><span id="selectedsets"></span></a><div id="obscure"></div><div id="apisets"><ul></ul></div></div><div class="toc"><h2>BigInt</h2><div class="navgroup"><div class="group collapsed"><a href="#InstanceMethods" onclick="expandoClicked(this.parentNode); return false;"><div class="arrow"></div>Instance Methods</a><div class="subgroup"><a href="#asIntN_Number_BigInt">asIntN</a><a href="#asUintN_Number_BigInt">asUintN</a></div></div></div><h2>JavaScript API</h2><div id="related-apis" class="navgroup"></div><h2>All API</h2><div id="rootObjs" class="navgroup"><span class="empty">No API set selected.</span></div></div></nav><div class="content"><h1 class="declaration"><span class="object">BigInt</span> <span class="type">: <a href="/Object">Object</a></span></h1><div class="metadata"><span>primitive</span></div><div class="objectdescription">An arbitrarily large integer value. Allows storing integers larger than what <a href="/Number">Number</a> allows. Use <a href="Number#Number_BigInt">Number(bigInt)</a> to convert a BigInt to a Number.<div class="membermetadata"><span class="ecmascript2020">ECMAScript 2020</span> <a href="https://tc39.es/ecma262/#sec-bigint-objects" class="spec">Spec</a></div></div><div><a name=""></a><h2></h2><div class="member"><div class="expand-members" title="Toggle showing all descriptions and examples"></div><a name="BigInt"></a> <a name="BigInt_Number"></a><div class="declaration"><span class="membername primary">BigInt</span>(<span class="membername">int</span> : <a class="membertype" href="/Number">Number</a>) : <a class="membertype" href="/BigInt">BigInt</a></div><div class="member-body"><p class="description">Creates a BigInt for the specified number. <code>int</code> should be between <a href="/Number#MIN_SAFE_INTEGER">Number.MIN_SAFE_INTEGER</a> and <a href="/Number#MIN_SAFE_INTEGER">Number.MAX_SAFE_INTEGER</a>.</p><div class="example"><div class="codePanel"><h4>Example:</h4><textarea class="code" rows="12" cols="60" wrap="off">
// The following are equivalent
const w = BigInt(15);
const x = 15n; // Decimal
const y = 0xFn; // Hex
const z = 0b1111n; // Binary
console.log(w + x);
</textarea><a onclick='executeExample(this.parentNode.parentNode, "BigInt.BigInt"); return false' href="#" class="run">Run</a></div><div class="resultsPanel"><h4>Results:</h4><div style="position: relative"><div class="errormessage" style="display: none"></div><pre class="results"> </pre></div></div></div><p></p><div class="membermetadata"><a href="https://tc39.es/ecma262/#sec-bigint-constructor-number-value" class="spec">Spec</a></div></div></div><div class="member"><div class="expand-members" title="Toggle showing all descriptions and examples"></div><a name="BigInt"></a> <a name="BigInt_String"></a><div class="declaration"><span class="membername primary">BigInt</span>(<span class="membername">int</span> : <a class="membertype" href="/String">String</a>) : <a class="membertype" href="/BigInt">BigInt</a></div><div class="member-body"><p class="description">Converts the specified string to a BigInt. Allows constructing BigInts larger than <a href="/Number">Number</a>s.</p><div class="example"><div class="codePanel"><h4>Example:</h4><textarea class="code" rows="12" cols="60" wrap="off">
// The following are equivalent
const x = BigInt('15');
const y = BigInt('0xF'); // Hex
const z = BigInt('0b1111'); // Binary
// The String constructor allows creating BigInts larger than Number allows
const a = BigInt('9999999999999999');
const b = BigInt(9999999999999999); // Exceeds Number.MAX_SAFE_INTEGER
const c = 9999999999999999n;
console.log(a);
console.log(b);
console.log(c);
</textarea><a onclick='executeExample(this.parentNode.parentNode, "BigInt.BigInt"); return false' href="#" class="run">Run</a></div><div class="resultsPanel"><h4>Results:</h4><div style="position: relative"><div class="errormessage" style="display: none"></div><pre class="results"> </pre></div></div></div><p></p><div class="membermetadata"><a href="https://tc39.es/ecma262/#sec-bigint-constructor-number-value" class="spec">Spec</a></div></div></div></div><div><a name="InstanceMethods"></a><h2>Instance Methods</h2><div class="member"><div class="expand-members" title="Toggle showing all descriptions and examples"></div><a name="asIntN"></a> <a name="asIntN_Number_BigInt"></a><div class="declaration"><span class="membername primary">asIntN</span>(<span class="membername">n</span> : <a class="membertype" href="/Number">Number</a>, <span class="membername">bigInt</span> : <a class="membertype" href="/BigInt">BigInt</a>) : <a class="membertype" href="/BigInt">BigInt</a></div><div class="member-body"><p class="description">Truncates <code>bigInt</code> to an <code>n</code>-bit signed integer.</p><div class="example"><div class="codePanel"><h4>Example:</h4><textarea class="code" rows="12" cols="60" wrap="off">
console.log(BigInt.asIntN(16, 0x0001n));
console.log(BigInt.asIntN(16, 0x7FFFn));
console.log(BigInt.asIntN(16, 0x8000n));
console.log(BigInt.asIntN(16, 0xFFFFn));
console.log(BigInt.asIntN(16, 0x10000n));
</textarea><a onclick='executeExample(this.parentNode.parentNode, "BigInt.asIntN"); return false' href="#" class="run">Run</a></div><div class="resultsPanel"><h4>Results:</h4><div style="position: relative"><div class="errormessage" style="display: none"></div><pre class="results"> </pre></div></div></div><p></p><div class="membermetadata"><a href="https://tc39.es/ecma262/#sec-bigint.asintn" class="spec">Spec</a></div></div></div><div class="member"><div class="expand-members" title="Toggle showing all descriptions and examples"></div><a name="asUintN"></a> <a name="asUintN_Number_BigInt"></a><div class="declaration"><span class="membername primary">asUintN</span>(<span class="membername">n</span> : <a class="membertype" href="/Number">Number</a>, <span class="membername">bigInt</span> : <a class="membertype" href="/BigInt">BigInt</a>) : <a class="membertype" href="/BigInt">BigInt</a></div><div class="member-body"><p class="description">Truncates <code>bigInt</code> to an <code>n</code>-bit unsigned integer.</p><div class="example"><div class="codePanel"><h4>Example:</h4><textarea class="code" rows="12" cols="60" wrap="off">
console.log(BigInt.asUintN(16, 0x0001n));
console.log(BigInt.asUintN(16, 0x7FFFn));
console.log(BigInt.asUintN(16, 0x8000n));
console.log(BigInt.asUintN(16, 0xFFFFn));
console.log(BigInt.asUintN(16, 0x10000n));
</textarea><a onclick='executeExample(this.parentNode.parentNode, "BigInt.asUintN"); return false' href="#" class="run">Run</a></div><div class="resultsPanel"><h4>Results:</h4><div style="position: relative"><div class="errormessage" style="display: none"></div><pre class="results"> </pre></div></div></div><p></p><div class="membermetadata"><a href="https://tc39.es/ecma262/#sec-bigint.asuintn" class="spec">Spec</a></div></div></div></div><div class="bottomnav"><a href="/">home</a> <a href="/license">license</a> <a href="https://github.com/nkronlage/JavaScripture">contribute</a> <a href="/feedback">feedback</a> <a id="toggle-theme" href="#">toggle light/dark mode</a></div><div class="copyright">Copyright © JavaScripture Contributors</div></div></div></body><script src="javascripture.js"></script></html>