You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@datasketches.apache.org by gi...@apache.org on 2025/02/18 19:33:37 UTC
(datasketches-memory) branch gh-pages updated: Deploying to gh-pages from @ apache/datasketches-memory@2ffc5dbc7de6dc83be4c1c37a068e85dc90c488e 🚀
This is an automated email from the ASF dual-hosted git repository.
github-bot pushed a commit to branch gh-pages
in repository https://gitbox.apache.org/repos/asf/datasketches-memory.git
The following commit(s) were added to refs/heads/gh-pages by this push:
new 91137a46 Deploying to gh-pages from @ apache/datasketches-memory@2ffc5dbc7de6dc83be4c1c37a068e85dc90c488e 🚀
91137a46 is described below
commit 91137a460b9146e1b81e1ebdd674d415b03a5596
Author: leerho <le...@users.noreply.github.com>
AuthorDate: Tue Feb 18 19:33:32 2025 +0000
Deploying to gh-pages from @ apache/datasketches-memory@2ffc5dbc7de6dc83be4c1c37a068e85dc90c488e 🚀
---
docs/main/allclasses-index.html | 37 +-
docs/main/allpackages-index.html | 8 +-
docs/main/help-doc.html | 8 +-
docs/main/index-all.html | 121 ++-----
docs/main/index.html | 6 +-
docs/main/member-search-index.js | 2 +-
.../org/apache/datasketches/memory/Buffer.html | 12 +-
.../memory/BufferPositionInvariantsException.html | 8 +-
.../memory/DefaultMemoryRequestServer.html | 158 ++++++---
.../org/apache/datasketches/memory/Memory.html | 12 +-
.../datasketches/memory/MemoryRequestServer.html | 97 ++---
.../apache/datasketches/memory/MurmurHash3.html | 395 ---------------------
.../org/apache/datasketches/memory/Positional.html | 8 +-
.../org/apache/datasketches/memory/Resource.html | 242 ++++++-------
.../apache/datasketches/memory/WritableBuffer.html | 12 +-
.../apache/datasketches/memory/WritableMemory.html | 183 ++++------
.../org/apache/datasketches/memory/XxHash.html | 8 +-
.../datasketches/memory/class-use/Buffer.html | 8 +-
.../BufferPositionInvariantsException.html | 8 +-
.../class-use/DefaultMemoryRequestServer.html | 8 +-
.../datasketches/memory/class-use/Memory.html | 23 +-
.../memory/class-use/MemoryRequestServer.html | 39 +-
.../datasketches/memory/class-use/MurmurHash3.html | 61 ----
.../datasketches/memory/class-use/Positional.html | 8 +-
.../datasketches/memory/class-use/Resource.html | 13 +-
.../memory/class-use/WritableBuffer.html | 8 +-
.../memory/class-use/WritableMemory.html | 94 ++---
.../datasketches/memory/class-use/XxHash.html | 8 +-
.../datasketches/memory/package-summary.html | 37 +-
.../apache/datasketches/memory/package-tree.html | 31 +-
.../apache/datasketches/memory/package-use.html | 10 +-
docs/main/overview-tree.html | 31 +-
docs/main/search.html | 8 +-
docs/main/serialized-form.html | 8 +-
docs/main/type-search-index.js | 2 +-
35 files changed, 557 insertions(+), 1165 deletions(-)
diff --git a/docs/main/allclasses-index.html b/docs/main/allclasses-index.html
index 4d5eaa58..6890c143 100644
--- a/docs/main/allclasses-index.html
+++ b/docs/main/allclasses-index.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>All Classes and Interfaces (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>All Classes and Interfaces (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="class index">
<meta name="generator" content="javadoc/AllClassesIndexWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -67,7 +67,7 @@ loadScripts(document, 'script');</script>
<div class="col-first even-row-color all-classes-table all-classes-table-tab2"><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></div>
<div class="col-last even-row-color all-classes-table all-classes-table-tab2">
<div class="block">This example MemoryRequestServer is simple but demonstrates one of many ways to
- manage continuous requests for larger memory.</div>
+ manage continuous requests for larger or smaller memory.</div>
</div>
<div class="col-first odd-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></div>
<div class="col-last odd-row-color all-classes-table all-classes-table-tab1">
@@ -75,32 +75,27 @@ loadScripts(document, 'script');</script>
</div>
<div class="col-first even-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></div>
<div class="col-last even-row-color all-classes-table all-classes-table-tab1">
-<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more memory
+<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more or less memory
for heap and off-heap WritableMemory resources that are not file-memory-mapped backed resources.</div>
</div>
-<div class="col-first odd-row-color all-classes-table all-classes-table-tab2"><a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></div>
-<div class="col-last odd-row-color all-classes-table all-classes-table-tab2">
-<div class="block">The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
- excellent avalanche and 2-way bit independence properties.</div>
-</div>
-<div class="col-first even-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></div>
-<div class="col-last even-row-color all-classes-table all-classes-table-tab1">
+<div class="col-first odd-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></div>
+<div class="col-last odd-row-color all-classes-table all-classes-table-tab1">
<div class="block">Defines the relative positional API.</div>
</div>
-<div class="col-first odd-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></div>
-<div class="col-last odd-row-color all-classes-table all-classes-table-tab1">
+<div class="col-first even-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></div>
+<div class="col-last even-row-color all-classes-table all-classes-table-tab1">
<div class="block">The base class for Memory and Buffer plus some common static variables and check methods.</div>
</div>
-<div class="col-first even-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></div>
-<div class="col-last even-row-color all-classes-table all-classes-table-tab1">
+<div class="col-first odd-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></div>
+<div class="col-last odd-row-color all-classes-table all-classes-table-tab1">
<div class="block">Defines the writable API for relative positional access to a resource</div>
</div>
-<div class="col-first odd-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></div>
-<div class="col-last odd-row-color all-classes-table all-classes-table-tab1">
+<div class="col-first even-row-color all-classes-table all-classes-table-tab1"><a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></div>
+<div class="col-last even-row-color all-classes-table all-classes-table-tab1">
<div class="block">Defines the writable API for offset access to a resource.</div>
</div>
-<div class="col-first even-row-color all-classes-table all-classes-table-tab2"><a href="org/apache/datasketches/memory/XxHash.html" title="class in org.apache.datasketches.memory">XxHash</a></div>
-<div class="col-last even-row-color all-classes-table all-classes-table-tab2">
+<div class="col-first odd-row-color all-classes-table all-classes-table-tab2"><a href="org/apache/datasketches/memory/XxHash.html" title="class in org.apache.datasketches.memory">XxHash</a></div>
+<div class="col-last odd-row-color all-classes-table all-classes-table-tab2">
<div class="block">The XxHash is a fast, non-cryptographic, 64-bit hash function that has
excellent avalanche and 2-way bit independence properties.</div>
</div>
@@ -110,7 +105,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/allpackages-index.html b/docs/main/allpackages-index.html
index d1e06e92..d91d217c 100644
--- a/docs/main/allpackages-index.html
+++ b/docs/main/allpackages-index.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>All Packages (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>All Packages (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="package index">
<meta name="generator" content="javadoc/AllPackagesIndexWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -64,7 +64,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/help-doc.html b/docs/main/help-doc.html
index b5c8e3c5..413f2e82 100644
--- a/docs/main/help-doc.html
+++ b/docs/main/help-doc.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>API Help (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>API Help (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="help">
<meta name="generator" content="javadoc/HelpWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -184,7 +184,7 @@ The following sections describe the different kinds of pages in this collection.
<span class="help-footnote">This help file applies to API documentation generated by the standard doclet.</span></main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/index-all.html b/docs/main/index-all.html
index c8251976..074c83dd 100644
--- a/docs/main/index-all.html
+++ b/docs/main/index-all.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Index (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Index (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="index">
<meta name="generator" content="javadoc/IndexWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -65,15 +65,15 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">Creates on-heap WritableMemory with the given capacity and the given byte order.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long)" class="member-name-link">allocateDirect(long)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
+<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect(long, long, ByteOrder, MemoryRequestServer, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
<dd>
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect(long, long, ByteOrder, MemoryRequestServer, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
+<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect(long, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
<dd>
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect(long, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
+<dt><a href="org/apache/datasketches/memory/WritableMemory.html#allocateDirect(long,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect(long, MemoryRequestServer, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
<dd>
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</dd>
@@ -149,11 +149,6 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">Clears the bits defined by the bitMask</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/Resource.html#close()" class="member-name-link">close()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
-<dd>
-<div class="block"><i>From Java 21 java.lang.foreign.Arena::close():</i>
- Closes this arena.</div>
-</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)" class="member-name-link">compareTo(long, long, Resource, long, long)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
<div class="block">Compares the bytes of this Resource to <i>that</i> Resource.</div>
@@ -170,7 +165,7 @@ loadScripts(document, 'script');</script>
<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" class="type-name-link" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a> - Class in <a href="org/apache/datasketches/memory/package-summary.html">org.apache.datasketches.memory</a></dt>
<dd>
<div class="block">This example MemoryRequestServer is simple but demonstrates one of many ways to
- manage continuous requests for larger memory.</div>
+ manage continuous requests for larger or smaller memory.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#%3Cinit%3E()" class="member-name-link">DefaultMemoryRequestServer()</a> - Constructor for class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
<dd>
@@ -178,7 +173,11 @@ loadScripts(document, 'script');</script>
</dd>
<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#%3Cinit%3E(boolean,boolean)" class="member-name-link">DefaultMemoryRequestServer(boolean, boolean)</a> - Constructor for class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
<dd>
-<div class="block">Constructor with parameters</div>
+<div class="block">Optional constructor 1.</div>
+</dd>
+<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#%3Cinit%3E(long,java.nio.ByteOrder,boolean,boolean)" class="member-name-link">DefaultMemoryRequestServer(long, ByteOrder, boolean, boolean)</a> - Constructor for class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
+<dd>
+<div class="block">Optional constructor 2.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#defaultMemReqSvr" class="member-name-link">defaultMemReqSvr</a> - Static variable in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
@@ -231,6 +230,10 @@ loadScripts(document, 'script');</script>
</dl>
<h2 class="title" id="I:G">G</h2>
<dl class="index">
+<dt><a href="org/apache/datasketches/memory/Resource.html#getArena()" class="member-name-link">getArena()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
+<dd>
+<div class="block">Returns the arena used to create this resource and possibly other resources.</div>
+</dd>
<dt><a href="org/apache/datasketches/memory/WritableBuffer.html#getArray()" class="member-name-link">getArray()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></dt>
<dd>
<div class="block">Returns a copy of the primitive backing byte array.</div>
@@ -384,13 +387,18 @@ loadScripts(document, 'script');</script>
<div class="block">Gets the <a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory"><code>MemoryRequestServer</code></a> to request additional memory
for writable resources that are not file-memory-mapped.</div>
</dd>
+<dt><a href="org/apache/datasketches/memory/Resource.html#getMemorySegment()" class="member-name-link">getMemorySegment()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
+<dd>
+<div class="block">Gets the MemorySegment that backs this resource as a read-only MemorySegment.</div>
+</dd>
<dt><a href="org/apache/datasketches/memory/Positional.html#getPosition()" class="member-name-link">getPosition()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></dt>
<dd>
<div class="block">Gets the current position</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#getRelativeOffset(org.apache.datasketches.memory.Resource)" class="member-name-link">getRelativeOffset(Resource)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
-<div class="block">Gets the relative base offset of <i>this</i> with respect to <i>that</i>, defined as: <i>this</i> - <i>that</i>.</div>
+<div class="block">Gets the relative base offset of <i>this</i> resource with respect to <i>that</i> resource,
+ defined as: <i>this</i> - <i>that</i>.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Positional.html#getRemaining()" class="member-name-link">getRemaining()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></dt>
<dd>
@@ -431,42 +439,6 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">Returns true if this Memory is backed by a ByteBuffer.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(byte%5B%5D,long)" class="member-name-link">hash(byte[], long)</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(char%5B%5D,long)" class="member-name-link">hash(char[], long)</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(double,long,long%5B%5D)" class="member-name-link">hash(double, long, long[])</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(int%5B%5D,long)" class="member-name-link">hash(int[], long)</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(long%5B%5D,long)" class="member-name-link">hash(long[], long)</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(long,long,long%5B%5D)" class="member-name-link">hash(long, long, long[])</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(java.lang.foreign.MemorySegment,long,long,long,long%5B%5D)" class="member-name-link">hash(MemorySegment, long, long, long, long[])</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(java.lang.String,long,long%5B%5D)" class="member-name-link">hash(String, long, long[])</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html#hash(org.apache.datasketches.memory.Memory,long,long,long,long%5B%5D)" class="member-name-link">hash(Memory, long, long, long, long[])</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></dt>
-<dd>
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-</dd>
<dt><a href="org/apache/datasketches/memory/XxHash.html#hashByteArr(byte%5B%5D,int,int,long)" class="member-name-link">hashByteArr(byte[], int, int, long)</a> - Static method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/XxHash.html" title="class in org.apache.datasketches.memory">XxHash</a></dt>
<dd>
<div class="block">Hash the given arr starting at the given offset and continuing for the given length using the
@@ -539,10 +511,6 @@ loadScripts(document, 'script');</script>
<div class="block">Returns true if the Native ByteOrder is the same as the ByteOrder of the
current Buffer or Memory and the same ByteOrder as the given byteOrder.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/Resource.html#isCloseable()" class="member-name-link">isCloseable()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
-<dd>
-<div class="block">Return true if this resource is likely to be closeable, but not guaranteed.</div>
-</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#isDirect()" class="member-name-link">isDirect()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
<div class="block">Returns true if the backing resource is direct (off-heap) memory.</div>
@@ -577,7 +545,7 @@ loadScripts(document, 'script');</script>
</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#isSameResource(org.apache.datasketches.memory.Resource)" class="member-name-link">isSameResource(Resource)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
-<div class="block">Returns true if the underlying resource is the same underlying resource as <i>that</i>.</div>
+<div class="block">Returns true if the underlying resource is the same resource as <i>that</i>.</div>
</dd>
</dl>
<h2 class="title" id="I:L">L</h2>
@@ -605,7 +573,7 @@ loadScripts(document, 'script');</script>
</dd>
<dt><a href="org/apache/datasketches/memory/MemoryRequestServer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> - Interface in <a href="org/apache/datasketches/memory/package-summary.html">org.apache.datasketches.memory</a></dt>
<dd>
-<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more memory
+<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more or less memory
for heap and off-heap WritableMemory resources that are not file-memory-mapped backed resources.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#mismatch(org.apache.datasketches.memory.Resource)" class="member-name-link">mismatch(Resource)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
@@ -616,11 +584,6 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">Finds the first byte mismatch based on the given offsets</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/MurmurHash3.html" class="type-name-link" title="class in org.apache.datasketches.memory">MurmurHash3</a> - Class in <a href="org/apache/datasketches/memory/package-summary.html">org.apache.datasketches.memory</a></dt>
-<dd>
-<div class="block">The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
- excellent avalanche and 2-way bit independence properties.</div>
-</dd>
</dl>
<h2 class="title" id="I:N">N</h2>
<dl class="index">
@@ -818,25 +781,17 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">A region is a read-only view of this object.</div>
</dd>
+<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request(WritableMemory, long)</a> - Method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
+<dd> </dd>
<dt><a href="org/apache/datasketches/memory/MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request(WritableMemory, long)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></dt>
<dd>
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request(WritableMemory, long, Arena)</a> - Method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
+<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose(WritableMemory)</a> - Method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
<dd> </dd>
-<dt><a href="org/apache/datasketches/memory/MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request(WritableMemory, long, Arena)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></dt>
-<dd>
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</dd>
<dt><a href="org/apache/datasketches/memory/MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose(WritableMemory)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></dt>
<dd>
-<div class="block">Request to close the resource, if applicable.</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose(WritableMemory, WritableMemory)</a> - Method in class org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></dt>
-<dd> </dd>
-<dt><a href="org/apache/datasketches/memory/MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose(WritableMemory, WritableMemory)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></dt>
-<dd>
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="block">Request to close the given WritableMemory.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Positional.html#resetPosition()" class="member-name-link">resetPosition()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></dt>
<dd>
@@ -878,9 +833,9 @@ loadScripts(document, 'script');</script>
<dd>
<div class="block">Returns a new ByteBuffer with a copy of the data from this Memory object.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/Resource.html#toMemorySegment()" class="member-name-link">toMemorySegment()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
+<dt><a href="org/apache/datasketches/memory/Resource.html#toMemorySegment(java.lang.foreign.Arena,long)" class="member-name-link">toMemorySegment(Arena, long)</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
-<div class="block">Returns a copy of the underlying MemorySegment.</div>
+<div class="block">Returns a copy of the underlying MemorySegment in the given arena.</div>
</dd>
<dt><a href="org/apache/datasketches/memory/Resource.html#toString()" class="member-name-link">toString()</a> - Method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></dt>
<dd>
@@ -967,18 +922,14 @@ loadScripts(document, 'script');</script>
<div class="block">Returns a duplicate writable view of this Buffer with the same but independent values of
<i>start</i>, <i>position</i> and <i>end</i>, but with the specified byteOrder.</div>
</dd>
-<dt><a href="org/apache/datasketches/memory/WritableMemory.html#writableMap(java.io.File)" class="member-name-link">writableMap(File)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
-<dd>
-<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
-</dd>
-<dt><a href="org/apache/datasketches/memory/WritableMemory.html#writableMap(java.io.File,long,long,java.nio.ByteOrder)" class="member-name-link">writableMap(File, long, long, ByteOrder)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
-<dd>
-<div class="block">Maps the specified portion of the given file into Memory for write operations with Arena.ofConfined().</div>
-</dd>
<dt><a href="org/apache/datasketches/memory/WritableMemory.html#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)" class="member-name-link">writableMap(File, long, long, ByteOrder, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
<dd>
<div class="block">Maps the specified portion of the given file into Memory for write operations.</div>
</dd>
+<dt><a href="org/apache/datasketches/memory/WritableMemory.html#writableMap(java.io.File,java.lang.foreign.Arena)" class="member-name-link">writableMap(File, Arena)</a> - Static method in interface org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></dt>
+<dd>
+<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
+</dd>
<dt><a href="org/apache/datasketches/memory/WritableMemory.html" class="type-name-link" title="interface in org.apache.datasketches.memory">WritableMemory</a> - Interface in <a href="org/apache/datasketches/memory/package-summary.html">org.apache.datasketches.memory</a></dt>
<dd>
<div class="block">Defines the writable API for offset access to a resource.</div>
@@ -1080,7 +1031,7 @@ loadScripts(document, 'script');</script>
<a href="#I:A">A</a> <a href="#I:B">B</a> <a href="#I:C">C</a> <a href="#I:D">D</a> <a href="#I:E">E</a> <a href="#I:F">F</a> <a href="#I:G">G</a> <a href="#I:H">H</a> <a href="#I:I">I</a> <a href="#I:L">L</a> <a href="#I:M">M</a> <a href="#I:N">N</a> <a href="#I:O">O</a> <a href="#I:P">P</a> <a href="#I:R">R</a> <a href="#I:S">S</a> <a href="#I:T">T</a> <a href="#I:U">U</a> <a href="#I:W">W</a>&nbs [...]
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/index.html b/docs/main/index.html
index 9eb4bebe..c8a34389 100644
--- a/docs/main/index.html
+++ b/docs/main/index.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>datasketches-memory 5.0.0-SNAPSHOT API</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>datasketches-memory 6.1.0-SNAPSHOT API</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="index redirect">
<meta name="generator" content="javadoc/IndexRedirectWriter">
<link rel="canonical" href="org/apache/datasketches/memory/package-summary.html">
diff --git a/docs/main/member-search-index.js b/docs/main/member-search-index.js
index 8a7e904a..e32dcd9e 100644
--- a/docs/main/member-search-index.js
+++ b/docs/main/member-search-index.js
@@ -1 +1 @@
-memberSearchIndex = [{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int, ByteOrder)","u":"allocate(int,java.nio.ByteOrder)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int, ByteOrder, MemoryRequestServer)","u":"allocate(int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory", [...]
\ No newline at end of file
+memberSearchIndex = [{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int, ByteOrder)","u":"allocate(int,java.nio.ByteOrder)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory","l":"allocate(int, ByteOrder, MemoryRequestServer)","u":"allocate(int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)"},{"p":"org.apache.datasketches.memory","c":"WritableMemory", [...]
\ No newline at end of file
diff --git a/docs/main/org/apache/datasketches/memory/Buffer.html b/docs/main/org/apache/datasketches/memory/Buffer.html
index c2644e31..8eebd26b 100644
--- a/docs/main/org/apache/datasketches/memory/Buffer.html
+++ b/docs/main/org/apache/datasketches/memory/Buffer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Buffer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Buffer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: Buffer">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -88,7 +88,7 @@ loadScripts(document, 'script');</script>
<section class="class-description" id="class-description">
<dl class="notes">
<dt>All Superinterfaces:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
+<dd><code><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
</dl>
<dl class="notes">
<dt>All Known Subinterfaces:</dt>
@@ -310,7 +310,7 @@ extends <a href="Positional.html" title="interface in org.apache.datasketches.me
<code><a href="Positional.html#getEnd()">getEnd</a>, <a href="Positional.html#getPosition()">getPosition</a>, <a href="Positional.html#getRemaining()">getRemaining</a>, <a href="Positional.html#getStart()">getStart</a>, <a href="Positional.html#hasRemaining()">hasRemaining</a>, <a href="Positional.html#incrementPosition(long)">incrementPosition</a>, <a href="Positional.html#resetPosition()">resetPosition</a>, <a href="Positional.html#setPosition(long)">setPosition</a>, <a href="Positiona [...]
<div class="inherited-list">
<h3 id="methods-inherited-from-class-org.apache.datasketches.memory.Resource">Methods inherited from interface org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></h3>
-<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#close()">close</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.ht [...]
+<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.html#getArena()">getArena</a>, <a href="Resou [...]
</section>
</li>
</ul>
@@ -815,7 +815,7 @@ extends <a href="Positional.html" title="interface in org.apache.datasketches.me
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/BufferPositionInvariantsException.html b/docs/main/org/apache/datasketches/memory/BufferPositionInvariantsException.html
index 48064f76..cfa9104f 100644
--- a/docs/main/org/apache/datasketches/memory/BufferPositionInvariantsException.html
+++ b/docs/main/org/apache/datasketches/memory/BufferPositionInvariantsException.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>BufferPositionInvariantsException (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>BufferPositionInvariantsException (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, class: BufferPositionInvariantsException">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -172,7 +172,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/DefaultMemoryRequestServer.html b/docs/main/org/apache/datasketches/memory/DefaultMemoryRequestServer.html
index b6043592..10dc2d75 100644
--- a/docs/main/org/apache/datasketches/memory/DefaultMemoryRequestServer.html
+++ b/docs/main/org/apache/datasketches/memory/DefaultMemoryRequestServer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>DefaultMemoryRequestServer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>DefaultMemoryRequestServer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, class: DefaultMemoryRequestServer">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -97,16 +97,50 @@ loadScripts(document, 'script');</script>
<div class="type-signature"><span class="modifiers">public final class </span><span class="element-name type-name-label">DefaultMemoryRequestServer</span>
<span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a>
implements <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></span></div>
-<div class="preview-block" id="preview-org.apache.datasketches.memory.DefaultMemoryRequestServer"><span class="preview-label"><code>DefaultMemoryRequestServer</code> relies on preview features of the Java platform:</span>
-<ul class="preview-comment">
-<li><code>DefaultMemoryRequestServer</code> refers to one or more preview APIs: <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link"><code>Arena</code></a>.</li>
-</ul>
-<div class="preview-comment">Programs can only use <code>DefaultMemoryRequestServer</code> when preview features are enabled.</div>
-<div class="preview-comment">Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.</div>
-</div>
<div class="block">This example MemoryRequestServer is simple but demonstrates one of many ways to
- manage continuous requests for larger memory.
- This capability is only available for writable, non-file-memory-mapping resources.</div>
+ manage continuous requests for larger or smaller memory.
+ This capability is only available for writable, non-file-memory-mapping resources.
+
+ <p>The operation of this implementation is controlled by three conditions:</p>
+ <ul>
+ <li><b><i>origOffHeap:</i></b> If <i>true</i>, the originally allocated WritableMemory is off-heap.</li>
+
+ <li><b><i>oneArena:</i></b> If <i>true</i>, all subsequent off-heap allocations will use the same Arena
+ obtained from the original off-heap WritableMemory. Otherwise, subsequent off-heap allocations will
+ use a new confined Arena created by this implementation.</li>
+
+ <li><b><i>offHeap:</i></b> If <i>true</i>, all subsequent allocations will be off-heap.
+ If the originally allocated WritableMemory is on-heap, this variable is ignored.</li>
+ </ul>
+
+ <p>These three variables work together as follows:</p>
+
+ <ul>
+ <li>If the original WritableMemory is on-heap, all subsequent allocations will also be on-heap.</li>
+
+ <li>If <i>origOffHeap</i> = <i>true</i>, <i>oneArena</i> = <i>true</i>, and <i>offHeap</i> = <i>true</i>,
+ all subsequent allocations will also be off-heap and associated with the original Arena.
+ It is the responsibility of the user to close the original Arena using a Try-With-Resource block, or directly.</li>
+
+ <li>If the original WritableMemory is off-heap, <i>oneArena</i> is true, and <i>offHeap</i> is false,
+ all subsequent allocations will be on-heap.
+ It is the responsibility of the user to close the original Arena using a Try-With-Resource block, or directly.</li>
+
+ <li>If the original WritableMemory is off-heap, <i>oneArena</i> is false, and <i>offHeap</i> is true,
+ all subsequent allocations will also be off-heap and associated with a new confined Arena assigned by this implementation.
+ It is the responsibility of the user to close the original Arena using a Try-With-Resource block, or directly,
+ and close the last returned new WritableMemory directly.</li>
+ </ul>
+
+ <p>In summary:</p>
+
+ <table> <caption><b>Configuration Options</b></caption>
+ <tr><th>Original Off-Heap</th> <th>OneArena</th> <th>OffHeap</th> <th>Subsequent Allocations</th></tr>
+ <tr><td>false</td> <td>N/A</td> <td>N/A</td> <td>All on-heap</td></tr>
+ <tr><td>true</td> <td>N/A</td> <td>false</td> <td>All on-heap</td></tr>
+ <tr><td>true</td> <td>true</td> <td>true</td> <td>All off-heap in original Arena</td></tr>
+ <tr><td>true</td> <td>false</td> <td>true</td> <td>All off-heap in separate Arenas</td></tr>
+ </table></div>
<dl class="notes">
<dt>Author:</dt>
<dd>Lee Rhodes</dd>
@@ -126,10 +160,17 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
<div class="col-last even-row-color">
<div class="block">Default constructor.</div>
</div>
-<div class="col-constructor-name odd-row-color"><code><a href="#%3Cinit%3E(boolean,boolean)" class="member-name-link">DefaultMemoryRequestServer</a><wbr>(boolean offHeap,
- boolean copyOldToNew)</code></div>
+<div class="col-constructor-name odd-row-color"><code><a href="#%3Cinit%3E(boolean,boolean)" class="member-name-link">DefaultMemoryRequestServer</a><wbr>(boolean oneArena,
+ boolean offHeap)</code></div>
<div class="col-last odd-row-color">
-<div class="block">Constructor with parameters</div>
+<div class="block">Optional constructor 1.</div>
+</div>
+<div class="col-constructor-name even-row-color"><code><a href="#%3Cinit%3E(long,java.nio.ByteOrder,boolean,boolean)" class="member-name-link">DefaultMemoryRequestServer</a><wbr>(long alignmentBytes,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+ boolean oneArena,
+ boolean offHeap)</code></div>
+<div class="col-last even-row-color">
+<div class="block">Optional constructor 2.</div>
</div>
</div>
</section>
@@ -146,17 +187,15 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
<div class="table-header col-second">Method</div>
<div class="table-header col-last">Description</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWmem,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
+ long newCapacityBytes)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code>void</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4"><code><a href="#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab4">
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="block">Request to close the given WritableMemory.</div>
</div>
</div>
</div>
@@ -164,9 +203,6 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
<div class="inherited-list">
<h3 id="methods-inherited-from-class-java.lang.Object">Methods inherited from class java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></h3>
<code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#hashCode()" title="cla [...]
-<div class="inherited-list">
-<h3 id="methods-inherited-from-class-org.apache.datasketches.memory.MemoryRequestServer">Methods inherited from interface org.apache.datasketches.memory.<a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></h3>
-<code><a href="MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)">request</a>, <a href="MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)">requestClose</a></code></div>
</section>
</li>
</ul>
@@ -182,21 +218,36 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
<section class="detail" id="<init>()">
<h3>DefaultMemoryRequestServer</h3>
<div class="member-signature"><span class="modifiers">public</span> <span class="element-name">DefaultMemoryRequestServer</span>()</div>
-<div class="block">Default constructor.
- Create new memory on-heap and do not copy old contents to new memory.</div>
+<div class="block">Default constructor.</div>
</section>
</li>
<li>
<section class="detail" id="<init>(boolean,boolean)">
<h3>DefaultMemoryRequestServer</h3>
-<div class="member-signature"><span class="modifiers">public</span> <span class="element-name">DefaultMemoryRequestServer</span><wbr><span class="parameters">(boolean offHeap,
- boolean copyOldToNew)</span></div>
-<div class="block">Constructor with parameters</div>
+<div class="member-signature"><span class="modifiers">public</span> <span class="element-name">DefaultMemoryRequestServer</span><wbr><span class="parameters">(boolean oneArena,
+ boolean offHeap)</span></div>
+<div class="block">Optional constructor 1.</div>
+<dl class="notes">
+<dt>Parameters:</dt>
+<dd><code>oneArena</code> - if true, the original arena will be used for all requested allocations.</dd>
+<dd><code>offHeap</code> - if true, new allocations will be off-heap.</dd>
+</dl>
+</section>
+</li>
+<li>
+<section class="detail" id="<init>(long,java.nio.ByteOrder,boolean,boolean)">
+<h3>DefaultMemoryRequestServer</h3>
+<div class="member-signature"><span class="modifiers">public</span> <span class="element-name">DefaultMemoryRequestServer</span><wbr><span class="parameters">(long alignmentBytes,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+ boolean oneArena,
+ boolean offHeap)</span></div>
+<div class="block">Optional constructor 2.</div>
<dl class="notes">
<dt>Parameters:</dt>
-<dd><code>offHeap</code> - if true, the returned new memory will be off heap</dd>
-<dd><code>copyOldToNew</code> - if true, the data from the current memory will be copied to the new memory,
- starting at address 0, and through the currentMemory capacity.</dd>
+<dd><code>alignmentBytes</code> - requested segment alignment for all allocations. Typically 1, 2, 4 or 8.</dd>
+<dd><code>byteOrder</code> - the given <i>ByteOrder</i>. It must be non-null.</dd>
+<dd><code>oneArena</code> - if true, the same arena will be used for all requested allocations.</dd>
+<dd><code>offHeap</code> - if true, new allocations will be off-heap.</dd>
</dl>
</section>
</li>
@@ -209,42 +260,37 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
<h2>Method Details</h2>
<ul class="member-list">
<li>
-<section class="detail" id="request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)">
+<section class="detail" id="request(org.apache.datasketches.memory.WritableMemory,long)">
<h3>request</h3>
-<div class="member-signature"><span class="modifiers">public</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">request</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWmem,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</span></div>
-<div class="block"><span class="description-from-type-label">Description copied from interface: <code><a href="MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)">MemoryRequestServer</a></code></span></div>
-<div class="block">Request new WritableMemory with the given newCapacityBytes. The current Writable Memory can be used to
- determine the byte order of the returned WritableMemory and other properties.</div>
+<div class="member-signature"><span class="modifiers">public</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">request</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
+ long newCapacityBytes)</span></div>
+<div class="block"><span class="description-from-type-label">Description copied from interface: <code><a href="MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)">MemoryRequestServer</a></code></span></div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
<dl class="notes">
<dt>Specified by:</dt>
-<dd><code><a href="MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)">request</a></code> in interface <code><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></code></dd>
+<dd><code><a href="MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)">request</a></code> in interface <code><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></code></dd>
<dt>Parameters:</dt>
-<dd><code>currentWmem</code> - the current writableMemory of the client. It must be non-null.</dd>
-<dd><code>newCapacityBytes</code> - The capacity being requested. It must be > the capacity of the currentWritableMemory.</dd>
-<dd><code>arena</code> - the Arena to be used for the newly allocated memory. It must be non-null.
- Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
+<dd><code>oldWmem</code> - the previous WritableMemory to be possibly closed and which provides an associated Arena
+ that may be used for allocating the new WritableMemory.
+ If the arena is null, the requested WritableMemory will be on-heap.</dd>
+<dd><code>newCapacityBytes</code> - The capacity being requested.</dd>
<dt>Returns:</dt>
<dd>new WritableMemory with the requested capacity.</dd>
</dl>
</section>
</li>
<li>
-<section class="detail" id="requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)">
+<section class="detail" id="requestClose(org.apache.datasketches.memory.WritableMemory)">
<h3>requestClose</h3>
-<div class="member-signature"><span class="modifiers">public</span> <span class="return-type">void</span> <span class="element-name">requestClose</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</span></div>
-<div class="block"><span class="description-from-type-label">Description copied from interface: <code><a href="MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)">MemoryRequestServer</a></code></span></div>
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="member-signature"><span class="modifiers">public</span> <span class="return-type">void</span> <span class="element-name">requestClose</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</span></div>
+<div class="block"><span class="description-from-type-label">Description copied from interface: <code><a href="MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)">MemoryRequestServer</a></code></span></div>
+<div class="block">Request to close the given WritableMemory. If applicable, it will be closed by its associated Arena.
+ Be careful. Closing the associated Arena may be closing other resources as well.</div>
<dl class="notes">
<dt>Specified by:</dt>
-<dd><code><a href="MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)">requestClose</a></code> in interface <code><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></code></dd>
+<dd><code><a href="MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)">requestClose</a></code> in interface <code><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></code></dd>
<dt>Parameters:</dt>
-<dd><code>memToClose</code> - the relevant WritableMemory to be considered for closing. It must be non-null.</dd>
-<dd><code>newMemory</code> - the newly allocated WritableMemory.
- The newMemory reference is returned from the client for the convenience of the system that
- owns the responsibility of memory allocation. It may be null.</dd>
+<dd><code>wmemToClose</code> - the given WritableMemory to close.</dd>
</dl>
</section>
</li>
@@ -257,7 +303,7 @@ implements <a href="MemoryRequestServer.html" title="interface in org.apache.dat
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/Memory.html b/docs/main/org/apache/datasketches/memory/Memory.html
index b1b9b0ac..a2fdf0aa 100644
--- a/docs/main/org/apache/datasketches/memory/Memory.html
+++ b/docs/main/org/apache/datasketches/memory/Memory.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Memory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Memory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: Memory">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -88,7 +88,7 @@ loadScripts(document, 'script');</script>
<section class="class-description" id="class-description">
<dl class="notes">
<dt>All Superinterfaces:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
+<dd><code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
</dl>
<dl class="notes">
<dt>All Known Subinterfaces:</dt>
@@ -351,7 +351,7 @@ extends <a href="Resource.html" title="interface in org.apache.datasketches.memo
</div>
<div class="inherited-list">
<h3 id="methods-inherited-from-class-org.apache.datasketches.memory.Resource">Methods inherited from interface org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></h3>
-<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#close()">close</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.ht [...]
+<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.html#getArena()">getArena</a>, <a href="Resou [...]
</section>
</li>
</ul>
@@ -933,7 +933,7 @@ extends <a href="Resource.html" title="interface in org.apache.datasketches.memo
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/MemoryRequestServer.html b/docs/main/org/apache/datasketches/memory/MemoryRequestServer.html
index c1bb23bc..9130224f 100644
--- a/docs/main/org/apache/datasketches/memory/MemoryRequestServer.html
+++ b/docs/main/org/apache/datasketches/memory/MemoryRequestServer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>MemoryRequestServer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>MemoryRequestServer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: MemoryRequestServer">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -92,14 +92,7 @@ loadScripts(document, 'script');</script>
</dl>
<hr>
<div class="type-signature"><span class="modifiers">public interface </span><span class="element-name type-name-label">MemoryRequestServer</span></div>
-<div class="preview-block" id="preview-org.apache.datasketches.memory.MemoryRequestServer"><span class="preview-label"><code>MemoryRequestServer</code> relies on preview features of the Java platform:</span>
-<ul class="preview-comment">
-<li><code>MemoryRequestServer</code> refers to one or more preview APIs: <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link"><code>Arena</code></a>.</li>
-</ul>
-<div class="preview-comment">Programs can only use <code>MemoryRequestServer</code> when preview features are enabled.</div>
-<div class="preview-comment">Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.</div>
-</div>
-<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more memory
+<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more or less memory
for heap and off-heap WritableMemory resources that are not file-memory-mapped backed resources.
<p>Note: this only works with Java 21.</div>
@@ -115,35 +108,22 @@ loadScripts(document, 'script');</script>
<section class="method-summary" id="method-summary">
<h2>Method Summary</h2>
<div id="method-summary-table">
-<div class="table-tabs" role="tablist" aria-orientation="horizontal"><button id="method-summary-table-tab0" role="tab" aria-selected="true" aria-controls="method-summary-table.tabpanel" tabindex="0" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table', 3)" class="active-table-tab">All Methods</button><button id="method-summary-table-tab2" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab( [...]
+<div class="table-tabs" role="tablist" aria-orientation="horizontal"><button id="method-summary-table-tab0" role="tab" aria-selected="true" aria-controls="method-summary-table.tabpanel" tabindex="0" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table', 3)" class="active-table-tab">All Methods</button><button id="method-summary-table-tab2" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab( [...]
<div id="method-summary-table.tabpanel" role="tabpanel" aria-labelledby="method-summary-table-tab0">
<div class="summary-table three-column-summary">
<div class="table-header col-first">Modifier and Type</div>
<div class="table-header col-second">Method</div>
<div class="table-header col-last">Description</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
long newCapacityBytes)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default void</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>void</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="block">Request to close the given WritableMemory.</div>
</div>
</div>
</div>
@@ -162,34 +142,15 @@ loadScripts(document, 'script');</script>
<li>
<section class="detail" id="request(org.apache.datasketches.memory.WritableMemory,long)">
<h3>request</h3>
-<div class="member-signature"><span class="modifiers">default</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">request</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
+<div class="member-signature"><span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">request</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
long newCapacityBytes)</span></div>
-<div class="block">Request new WritableMemory with the given newCapacityBytes. The current WritableMemory can be used to
- determine the byte order of the returned WritableMemory and other properties. A new confined Arena is
- assigned.</div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
<dl class="notes">
<dt>Parameters:</dt>
-<dd><code>currentWritableMemory</code> - the current writableMemory of the client. It must be non-null.</dd>
-<dd><code>newCapacityBytes</code> - The capacity being requested. It must be > the capacity of the currentWritableMemory.</dd>
-<dt>Returns:</dt>
-<dd>new WritableMemory with the requested capacity.</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)">
-<h3>request</h3>
-<div class="member-signature"><span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">request</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</span></div>
-<div class="block">Request new WritableMemory with the given newCapacityBytes. The current Writable Memory can be used to
- determine the byte order of the returned WritableMemory and other properties.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>currentWritableMemory</code> - the current writableMemory of the client. It must be non-null.</dd>
-<dd><code>newCapacityBytes</code> - The capacity being requested. It must be > the capacity of the currentWritableMemory.</dd>
-<dd><code>arena</code> - the Arena to be used for the newly allocated memory. It must be non-null.
- Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
+<dd><code>oldWmem</code> - the previous WritableMemory to be possibly closed and which provides an associated Arena
+ that may be used for allocating the new WritableMemory.
+ If the arena is null, the requested WritableMemory will be on-heap.</dd>
+<dd><code>newCapacityBytes</code> - The capacity being requested.</dd>
<dt>Returns:</dt>
<dd>new WritableMemory with the requested capacity.</dd>
</dl>
@@ -198,26 +159,12 @@ loadScripts(document, 'script');</script>
<li>
<section class="detail" id="requestClose(org.apache.datasketches.memory.WritableMemory)">
<h3>requestClose</h3>
-<div class="member-signature"><span class="modifiers">default</span> <span class="return-type">void</span> <span class="element-name">requestClose</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose)</span></div>
-<div class="block">Request to close the resource, if applicable.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>memToClose</code> - the relevant WritableMemory to be considered for closing. It must be non-null.</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)">
-<h3>requestClose</h3>
-<div class="member-signature"><span class="return-type">void</span> <span class="element-name">requestClose</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</span></div>
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="member-signature"><span class="return-type">void</span> <span class="element-name">requestClose</span><wbr><span class="parameters">(<a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</span></div>
+<div class="block">Request to close the given WritableMemory. If applicable, it will be closed by its associated Arena.
+ Be careful. Closing the associated Arena may be closing other resources as well.</div>
<dl class="notes">
<dt>Parameters:</dt>
-<dd><code>memToClose</code> - the relevant WritableMemory to be considered for closing. It must be non-null.</dd>
-<dd><code>newMemory</code> - the newly allocated WritableMemory.
- The newMemory reference is returned from the client for the convenience of the system that
- owns the responsibility of memory allocation. It may be null.</dd>
+<dd><code>wmemToClose</code> - the given WritableMemory to close.</dd>
</dl>
</section>
</li>
@@ -230,7 +177,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/MurmurHash3.html b/docs/main/org/apache/datasketches/memory/MurmurHash3.html
deleted file mode 100644
index 4137c60c..00000000
--- a/docs/main/org/apache/datasketches/memory/MurmurHash3.html
+++ /dev/null
@@ -1,395 +0,0 @@
-<!DOCTYPE HTML>
-<html lang>
-<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>MurmurHash3 (datasketches-memory 5.0.0-SNAPSHOT API)</title>
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
-<meta name="description" content="declaration: package: org.apache.datasketches.memory, class: MurmurHash3">
-<meta name="generator" content="javadoc/ClassWriterImpl">
-<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
-<link rel="stylesheet" type="text/css" href="../../../../script-dir/jquery-ui.min.css" title="Style">
-<script type="text/javascript" src="../../../../script.js"></script>
-<script type="text/javascript" src="../../../../script-dir/jquery-3.7.1.min.js"></script>
-<script type="text/javascript" src="../../../../script-dir/jquery-ui.min.js"></script>
-</head>
-<body class="class-declaration-page">
-<script type="text/javascript">var pathtoroot = "../../../../";
-loadScripts(document, 'script');</script>
-<noscript>
-<div>JavaScript is disabled on your browser.</div>
-</noscript>
-<div class="flex-box">
-<header role="banner" class="flex-header">
-<nav role="navigation">
-<!-- ========= START OF TOP NAVBAR ======= -->
-<div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span></button>
-<div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
-<ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
-<li><a href="package-summary.html">Package</a></li>
-<li class="nav-bar-cell1-rev">Class</li>
-<li><a href="class-use/MurmurHash3.html">Use</a></li>
-<li><a href="package-tree.html">Tree</a></li>
-<li><a href="../../../../index-all.html">Index</a></li>
-<li><a href="../../../../help-doc.html#class">Help</a></li>
-</ul>
-<ul class="sub-nav-list-small">
-<li>
-<p>Summary:</p>
-<ul>
-<li>Nested</li>
-<li>Field</li>
-<li>Constr</li>
-<li><a href="#method-summary">Method</a></li>
-</ul>
-</li>
-<li>
-<p>Detail:</p>
-<ul>
-<li>Field</li>
-<li>Constr</li>
-<li><a href="#method-detail">Method</a></li>
-</ul>
-</li>
-</ul>
-</div>
-<div class="sub-nav">
-<div id="navbar-sub-list">
-<ul class="sub-nav-list">
-<li>Summary: </li>
-<li>Nested | </li>
-<li>Field | </li>
-<li>Constr | </li>
-<li><a href="#method-summary">Method</a></li>
-</ul>
-<ul class="sub-nav-list">
-<li>Detail: </li>
-<li>Field | </li>
-<li>Constr | </li>
-<li><a href="#method-detail">Method</a></li>
-</ul>
-</div>
-<div class="nav-list-search"><a href="../../../../search.html">SEARCH</a>
-<input type="text" id="search-input" disabled placeholder="Search">
-<input type="reset" id="reset-button" disabled value="reset">
-</div>
-</div>
-<!-- ========= END OF TOP NAVBAR ========= -->
-<span class="skip-nav" id="skip-navbar-top"></span></nav>
-</header>
-<div class="flex-content">
-<main role="main">
-<!-- ======== START OF CLASS DATA ======== -->
-<div class="header">
-<div class="sub-title"><span class="package-label-in-type">Package</span> <a href="package-summary.html">org.apache.datasketches.memory</a></div>
-<h1 title="Class MurmurHash3" class="title">Class MurmurHash3</h1>
-</div>
-<div class="inheritance" title="Inheritance Tree"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">java.lang.Object</a>
-<div class="inheritance">org.apache.datasketches.memory.MurmurHash3</div>
-</div>
-<section class="class-description" id="class-description">
-<hr>
-<div class="type-signature"><span class="modifiers">public final class </span><span class="element-name type-name-label">MurmurHash3</span>
-<span class="extends-implements">extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></span></div>
-<div class="preview-block" id="preview-org.apache.datasketches.memory.MurmurHash3"><span class="preview-label"><code>MurmurHash3</code> relies on preview features of the Java platform:</span>
-<ul class="preview-comment">
-<li><code>MurmurHash3</code> refers to one or more preview APIs: <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link"><code>MemorySegment</code></a>.</li>
-</ul>
-<div class="preview-comment">Programs can only use <code>MurmurHash3</code> when preview features are enabled.</div>
-<div class="preview-comment">Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.</div>
-</div>
-<div class="block">The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
- excellent avalanche and 2-way bit independence properties.
-
- <p>Austin Appleby's C++
- <a href="https://github.com/aappleby/smhasher/blob/master/src/MurmurHash3.cpp">
- MurmurHash3_x64_128(...), final revision 150</a>,
- which is in the Public Domain, was the inspiration for this implementation in Java.</p>
-
- <p>This implementation of the MurmurHash3 allows hashing of a block of on-heap Memory defined by an offset
- and length. The calling API also allows the user to supply the small output array of two longs,
- so that the entire hash function is static and free of object allocations.</p>
-
- <p>This implementation produces exactly the same hash result as the
- MurmurHash3 function in datasketches-java given compatible inputs.</p>
-
- <p>This version 4 of the implementation leverages the java.lang.foreign package of JDK-21 in place of
- the Unsafe class.</div>
-<dl class="notes">
-<dt>Author:</dt>
-<dd>Lee Rhodes</dd>
-</dl>
-</section>
-<section class="summary">
-<ul class="summary-list">
-<!-- ========== METHOD SUMMARY =========== -->
-<li>
-<section class="method-summary" id="method-summary">
-<h2>Method Summary</h2>
-<div id="method-summary-table">
-<div class="table-tabs" role="tablist" aria-orientation="horizontal"><button id="method-summary-table-tab0" role="tab" aria-selected="true" aria-controls="method-summary-table.tabpanel" tabindex="0" onkeydown="switchTab(event)" onclick="show('method-summary-table', 'method-summary-table', 3)" class="active-table-tab">All Methods</button><button id="method-summary-table-tab1" role="tab" aria-selected="false" aria-controls="method-summary-table.tabpanel" tabindex="-1" onkeydown="switchTab( [...]
-<div id="method-summary-table.tabpanel" role="tabpanel" aria-labelledby="method-summary-table-tab0">
-<div class="summary-table three-column-summary">
-<div class="table-header col-first">Modifier and Type</div>
-<div class="table-header col-second">Method</div>
-<div class="table-header col-last">Description</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(byte%5B%5D,long)" class="member-name-link">hash</a><wbr>(byte[] in,
- long seed)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(char%5B%5D,long)" class="member-name-link">hash</a><wbr>(char[] in,
- long seed)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(double,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(double in,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(int%5B%5D,long)" class="member-name-link">hash</a><wbr>(int[] in,
- long seed)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(long%5B%5D,long)" class="member-name-link">hash</a><wbr>(long[] in,
- long seed)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(long,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(long in,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(java.lang.foreign.MemorySegment,long,long,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/ [...]
- long offsetBytes,
- long lengthBytes,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(java.lang.String,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a> in,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static long[]</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#hash(org.apache.datasketches.memory.Memory,long,long,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(<a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a> mem,
- long offsetBytes,
- long lengthBytes,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-</div>
-</div>
-</div>
-</div>
-<div class="inherited-list">
-<h3 id="methods-inherited-from-class-java.lang.Object">Methods inherited from class java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" title="class or interface in java.lang" class="external-link">Object</a></h3>
-<code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang" class="external-link">equals</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#getClass()" title="class or interface in java.lang" class="external-link">getClass</a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html#hashCode()" title="cla [...]
-</section>
-</li>
-</ul>
-</section>
-<section class="details">
-<ul class="details-list">
-<!-- ============ METHOD DETAIL ========== -->
-<li>
-<section class="method-details" id="method-detail">
-<h2>Method Details</h2>
-<ul class="member-list">
-<li>
-<section class="detail" id="hash(long[],long)">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(long[] in,
- long seed)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Provided for compatibility with older version of MurmurHash3,
- but empty or null input now throws IllegalArgumentException.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - long array</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(int[],long)">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(int[] in,
- long seed)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Provided for compatibility with older version of MurmurHash3,
- but empty or null input now throws IllegalArgumentException.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - int array</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(char[],long)">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(char[] in,
- long seed)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Provided for compatibility with older version of MurmurHash3,
- but empty or null input now throws IllegalArgumentException.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - char array</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(byte[],long)">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(byte[] in,
- long seed)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Provided for compatibility with older version of MurmurHash3,
- but empty or null input now throws IllegalArgumentException.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - byte array</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(long,long,long[])">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(long in,
- long seed,
- long[] hashOut)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Note the entropy of the resulting hash cannot be more than 64 bits.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - a long</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dd><code>hashOut</code> - A long array of size 2</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(double,long,long[])">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(double in,
- long seed,
- long[] hashOut)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- Note the entropy of the resulting hash cannot be more than 64 bits.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - a double</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dd><code>hashOut</code> - A long array of size 2</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(java.lang.String,long,long[])">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a> in,
- long seed,
- long[] hashOut)</span></div>
-<div class="block">Returns a 128-bit hash of the input.
- An empty or null input throws IllegalArgumentException.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>in</code> - a String</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dd><code>hashOut</code> - A long array of size 2</dd>
-<dt>Returns:</dt>
-<dd>the hash</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(org.apache.datasketches.memory.Memory,long,long,long,long[])">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(<a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a> mem,
- long offsetBytes,
- long lengthBytes,
- long seed,
- long[] hashOut)</span></div>
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>mem</code> - The input on-heap Memory. Must be non-null and non-empty.</dd>
-<dd><code>offsetBytes</code> - the starting point within Memory.</dd>
-<dd><code>lengthBytes</code> - the total number of bytes to be hashed.</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dd><code>hashOut</code> - the size 2 long array for the resulting 128-bit hash</dd>
-<dt>Returns:</dt>
-<dd>the hash.</dd>
-</dl>
-</section>
-</li>
-<li>
-<section class="detail" id="hash(java.lang.foreign.MemorySegment,long,long,long,long[])">
-<h3>hash</h3>
-<div class="member-signature"><span class="modifiers">public static</span> <span class="return-type">long[]</span> <span class="element-name">hash</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegm [...]
- long offsetBytes,
- long lengthBytes,
- long seed,
- long[] hashOut)</span></div>
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>seg</code> - The input MemorySegment. Must be non-null and non-empty.</dd>
-<dd><code>offsetBytes</code> - the starting point within Memory.</dd>
-<dd><code>lengthBytes</code> - the total number of bytes to be hashed.</dd>
-<dd><code>seed</code> - A long valued seed.</dd>
-<dd><code>hashOut</code> - the size 2 long array for the resulting 128-bit hash</dd>
-<dt>Returns:</dt>
-<dd>the hash.</dd>
-</dl>
-</section>
-</li>
-</ul>
-</section>
-</li>
-</ul>
-</section>
-<!-- ========= END OF CLASS DATA ========= -->
-</main>
-<footer role="contentinfo">
-<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
-</footer>
-</div>
-</div>
-</body>
-</html>
diff --git a/docs/main/org/apache/datasketches/memory/Positional.html b/docs/main/org/apache/datasketches/memory/Positional.html
index b6b16c69..ff4db6a7 100644
--- a/docs/main/org/apache/datasketches/memory/Positional.html
+++ b/docs/main/org/apache/datasketches/memory/Positional.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Positional (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Positional (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: Positional">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -314,7 +314,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/Resource.html b/docs/main/org/apache/datasketches/memory/Resource.html
index 1f319195..5c06bb3a 100644
--- a/docs/main/org/apache/datasketches/memory/Resource.html
+++ b/docs/main/org/apache/datasketches/memory/Resource.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Resource (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Resource (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: Resource">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -87,19 +87,14 @@ loadScripts(document, 'script');</script>
</div>
<section class="class-description" id="class-description">
<dl class="notes">
-<dt>All Superinterfaces:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd>
-</dl>
-<dl class="notes">
<dt>All Known Subinterfaces:</dt>
<dd><code><a href="Buffer.html" title="interface in org.apache.datasketches.memory">Buffer</a></code>, <code><a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></code>, <code><a href="WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></code>, <code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></dd>
</dl>
<hr>
-<div class="type-signature"><span class="modifiers">public interface </span><span class="element-name type-name-label">Resource</span><span class="extends-implements">
-extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></span></div>
+<div class="type-signature"><span class="modifiers">public interface </span><span class="element-name type-name-label">Resource</span></div>
<div class="preview-block" id="preview-org.apache.datasketches.memory.Resource"><span class="preview-label"><code>Resource</code> relies on preview features of the Java platform:</span>
<ul class="preview-comment">
-<li><code>Resource</code> refers to one or more preview APIs: <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link"><code>MemorySegment</code></a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html" title="class or interface in java.lang.foreign" class="external-link"><code>Scope</code></a>.</li>
+<li><code>Resource</code> refers to one or more preview APIs: <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link"><code>Arena</code></a>, <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link"><code>MemorySegment</code></a>, <a href="https://docs.ora [...]
</ul>
<div class="preview-comment">Programs can only use <code>Resource</code> when preview features are enabled.</div>
<div class="preview-comment">Preview features may be removed in a future release, or upgraded to permanent features of the Java platform.</div>
@@ -145,42 +140,41 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
<div class="block">Returns a ByteBuffer view of this Memory object with the given ByteOrder.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>void</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#close()" class="member-name-link">close</a>()</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block"><i>From Java 21 java.lang.foreign.Arena::close():</i>
- Closes this arena.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>int</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)" class="member-name-link">compareTo</a><wbr>(long thisOffsetBytes,
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>int</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)" class="member-name-link">compareTo</a><wbr>(long thisOffsetBytes,
long thisLengthBytes,
<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that,
long thatOffsetBytes,
long thatLengthBytes)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
<div class="block">Compares the bytes of this Resource to <i>that</i> Resource.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#equalTo(long,org.apache.datasketches.memory.Resource,long,long)" class="member-name-link">equalTo</a><wbr>(long thisOffsetBytes,
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#equalTo(long,org.apache.datasketches.memory.Resource,long,long)" class="member-name-link">equalTo</a><wbr>(long thisOffsetBytes,
<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that,
long thatOffsetBytes,
long lengthBytes)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
<div class="block">Returns true if the given object is an instance of this class and has equal contents to
this object in the given range of bytes.</div>
</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default boolean</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#equalTo(org.apache.datasketches.memory.Resource)" class="member-name-link">equalTo</a><wbr>(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default boolean</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#equalTo(org.apache.datasketches.memory.Resource)" class="member-name-link">equalTo</a><wbr>(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
<div class="block">Returns true if the given object is an instance of this class and has equal contents to
this object.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>void</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#force()" class="member-name-link">force</a>()</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>void</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#force()" class="member-name-link">force</a>()</code></div>
+<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
<div class="block">Forces any changes made to the contents of this mapped segment to be written to the storage device described
by the mapped segment's file descriptor.</div>
</div>
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="exter [...]
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getArena()" class="member-name-link">getArena</a>()</code></div>
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="block">Returns the arena used to create this resource and possibly other resources.</div>
+</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>long</code></div>
<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getCapacity()" class="member-name-link">getCapacity</a>()</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
@@ -192,46 +186,47 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<div class="block">Gets the <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory"><code>MemoryRequestServer</code></a> to request additional memory
for writable resources that are not file-memory-mapped.</div>
</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>long</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getRelativeOffset(org.apache.datasketches.memory.Resource)" class="member-name-link">getRelativeOffset</a><wbr>(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#preview-java.lang.foreign.MemorySegment" title="class or interface i [...]
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getMemorySegment()" class="member-name-link">getMemorySegment</a>()</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Gets the relative base offset of <i>this</i> with respect to <i>that</i>, defined as: <i>this</i> - <i>that</i>.</div>
+<div class="block">Gets the MemorySegment that backs this resource as a read-only MemorySegment.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getTypeByteOrder()" class="member-name-link">getTypeByteOrder</a>()</code></div>
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>long</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getRelativeOffset(org.apache.datasketches.memory.Resource)" class="member-name-link">getRelativeOffset</a><wbr>(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Gets the current Type ByteOrder.</div>
+<div class="block">Gets the relative base offset of <i>this</i> resource with respect to <i>that</i> resource,
+ defined as: <i>this</i> - <i>that</i>.</div>
</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#hasByteBuffer()" class="member-name-link">hasByteBuffer</a>()</code></div>
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a></code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#getTypeByteOrder()" class="member-name-link">getTypeByteOrder</a>()</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns true if this Memory is backed by a ByteBuffer.</div>
+<div class="block">Gets the current Type ByteOrder.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#hasMemoryRequestServer()" class="member-name-link">hasMemoryRequestServer</a>()</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#hasByteBuffer()" class="member-name-link">hasByteBuffer</a>()</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns true if the MemoryRequestServer has been configured by the user.</div>
+<div class="block">Returns true if this Memory is backed by a ByteBuffer.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isAlive()" class="member-name-link">isAlive</a>()</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#hasMemoryRequestServer()" class="member-name-link">hasMemoryRequestServer</a>()</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Is the underlying resource scope alive?</div>
+<div class="block">Returns true if the MemoryRequestServer has been configured by the user.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isBuffer()" class="member-name-link">isBuffer</a>()</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isAlive()" class="member-name-link">isAlive</a>()</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns true if this instance is a Buffer or WritableBuffer instance.</div>
+<div class="block">Is the underlying resource scope alive?</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isByteOrderCompatible(java.nio.ByteOrder)" class="member-name-link">isByteOrderCompatible</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isBuffer()" class="member-name-link">isBuffer</a>()</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns true if the Native ByteOrder is the same as the ByteOrder of the
- current Buffer or Memory and the same ByteOrder as the given byteOrder.</div>
+<div class="block">Returns true if this instance is a Buffer or WritableBuffer instance.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isCloseable()" class="member-name-link">isCloseable</a>()</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isByteOrderCompatible(java.nio.ByteOrder)" class="member-name-link">isByteOrderCompatible</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Return true if this resource is likely to be closeable, but not guaranteed.</div>
+<div class="block">Returns true if the Native ByteOrder is the same as the ByteOrder of the
+ current Buffer or Memory and the same ByteOrder as the given byteOrder.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isDirect()" class="member-name-link">isDirect</a>()</code></div>
@@ -276,7 +271,7 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>boolean</code></div>
<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#isSameResource(org.apache.datasketches.memory.Resource)" class="member-name-link">isSameResource</a><wbr>(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns true if the underlying resource is the same underlying resource as <i>that</i>.</div>
+<div class="block">Returns true if the underlying resource is the same resource as <i>that</i>.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code>void</code></div>
<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#load()" class="member-name-link">load</a>()</code></div>
@@ -321,9 +316,10 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<div class="block">Returns a new ByteBuffer with a copy of the data from this Memory object.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#preview-java.lang.foreign.MemorySegment" title="class or interface i [...]
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#toMemorySegment()" class="member-name-link">toMemorySegment</a>()</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#toMemorySegment(java.lang.foreign.Arena,long)" class="member-name-link">toMemorySegment</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/for [...]
+ long alignment)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
-<div class="block">Returns a copy of the underlying MemorySegment.</div>
+<div class="block">Returns a copy of the underlying MemorySegment in the given arena.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a></code></div>
<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#toString()" class="member-name-link">toString</a>()</code></div>
@@ -376,7 +372,8 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<section class="detail" id="defaultMemReqSvr">
<h3>defaultMemReqSvr</h3>
<div class="member-signature"><span class="modifiers">static final</span> <span class="return-type"><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></span> <span class="element-name">defaultMemReqSvr</span></div>
-<div class="block">The default MemoryRequestServer used primarily by test.</div>
+<div class="block">The default MemoryRequestServer used primarily by test.
+ Do not allocate requested memory off-heap.</div>
</section>
</li>
</ul>
@@ -458,41 +455,6 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
</section>
</li>
<li>
-<section class="detail" id="close()">
-<h3>close</h3>
-<div class="member-signature"><span class="return-type">void</span> <span class="element-name">close</span>()</div>
-<div class="block"><i>From Java 21 java.lang.foreign.Arena::close():</i>
- Closes this arena. If this method completes normally, the arena scope is no longer <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html#isAlive()" title="class or interface in java.lang.foreign" class="external-link">alive</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html#preview-java.lang.foreign.MemorySegment.Scope" title="class or interface in java.lang.f [...]
- and all the memory segments associated with it can no longer be accessed. Furthermore, any off-heap region of memory backing the
- segments obtained from this arena are also released.
-
- <p>This operation is not idempotent; that is, closing an already closed arena <em>always</em> results in an
- exception being thrown. This reflects a deliberate design choice: failure to close an arena might reveal a bug
- in the underlying application logic.</p>
-
- <p>If this method completes normally, then <code>java.lang.foreign.Arena.scope().isAlive() == false</code>.
- Implementations are allowed to throw <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang" class="external-link"><code>UnsupportedOperationException</code></a> if an explicit close operation is
- not supported.</p></div>
-<dl class="notes">
-<dt>Specified by:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html#close()" title="class or interface in java.lang" class="external-link">close</a></code> in interface <code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code></dd>
-<dt>Throws:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html" title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if the arena has already been closed.</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalStateException.html" title="class or interface in java.lang" class="external-link">IllegalStateException</a></code> - if a segment associated with this arena is being accessed concurrently, e.g.
- by a <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Linker.html#downcallHandle(java.lang.foreign.FunctionDescriptor,java.lang.foreign.Linker.Option...)" title="class or interface in java.lang.foreign" class="external-link">downcall method handle</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Linker.html#preview-java.lang.foreign.Linker" title="class or interface in java.lang.foreign" class="externa [...]
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/WrongThreadException.html" title="class or interface in java.lang" class="external-link">WrongThreadException</a></code> - if this arena is confined, and this method is called from a thread
- other than the arena's owner thread.</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - if this arena cannot be closed explicitly.</dd>
-<dt>See Also:</dt>
-<dd>
-<ul class="tag-list-long">
-<li><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html#isAlive()" title="class or interface in java.lang.foreign" class="external-link"><code>MemorySegment.Scope.isAlive()</code></a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html#preview-java.lang.foreign.MemorySegment.Scope" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></ [...]
-</ul>
-</dd>
-</dl>
-</section>
-</li>
-<li>
<section class="detail" id="compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">
<h3>compareTo</h3>
<div class="member-signature"><span class="return-type">int</span> <span class="element-name">compareTo</span><wbr><span class="parameters">(long thisOffsetBytes,
@@ -568,6 +530,18 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
</section>
</li>
<li>
+<section class="detail" id="getArena()">
+<h3>getArena</h3>
+<div class="member-signature"><span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup></span> <span class="element [...]
+<div class="block">Returns the arena used to create this resource and possibly other resources.
+ Be careful when you close the returned Arena, you may be closing other resources as well.</div>
+<dl class="notes">
+<dt>Returns:</dt>
+<dd>the arena used to create this resource and possibly other resources. It may be null.</dd>
+</dl>
+</section>
+</li>
+<li>
<section class="detail" id="getCapacity()">
<h3>getCapacity</h3>
<div class="member-signature"><span class="return-type">long</span> <span class="element-name">getCapacity</span>()</div>
@@ -579,18 +553,30 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
</section>
</li>
<li>
+<section class="detail" id="getMemorySegment()">
+<h3>getMemorySegment</h3>
+<div class="member-signature"><span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#preview-java.lang.foreign.MemorySegment" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup>< [...]
+<div class="block">Gets the MemorySegment that backs this resource as a read-only MemorySegment.</div>
+<dl class="notes">
+<dt>Returns:</dt>
+<dd>the MemorySegment that back this resource as a read-only MemorySegment.</dd>
+</dl>
+</section>
+</li>
+<li>
<section class="detail" id="getRelativeOffset(org.apache.datasketches.memory.Resource)">
<h3>getRelativeOffset</h3>
<div class="member-signature"><span class="return-type">long</span> <span class="element-name">getRelativeOffset</span><wbr><span class="parameters">(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</span></div>
-<div class="block">Gets the relative base offset of <i>this</i> with respect to <i>that</i>, defined as: <i>this</i> - <i>that</i>.
- This method is only valid for <i>native</i> (off-heap) allocated resources.</div>
+<div class="block">Gets the relative base offset of <i>this</i> resource with respect to <i>that</i> resource,
+ defined as: <i>this</i> - <i>that</i>.</div>
<dl class="notes">
<dt>Parameters:</dt>
<dd><code>that</code> - the given resource.</dd>
<dt>Returns:</dt>
<dd><i>this</i> - <i>that</i> offset</dd>
<dt>Throws:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - if one of the resources is on-heap.</dd>
+<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/UnsupportedOperationException.html" title="class or interface in java.lang" class="external-link">UnsupportedOperationException</a></code> - if the two resources cannot be compared, e.g. because they are of
+ different kinds, or because they are backed by different Java arrays.</dd>
</dl>
</section>
</li>
@@ -618,18 +604,6 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
</section>
</li>
<li>
-<section class="detail" id="isCloseable()">
-<h3>isCloseable</h3>
-<div class="member-signature"><span class="return-type">boolean</span> <span class="element-name">isCloseable</span>()</div>
-<div class="block">Return true if this resource is likely to be closeable, but not guaranteed.
- There is no way to determine if the specific type of Arena is explicitly closeable.</div>
-<dl class="notes">
-<dt>Returns:</dt>
-<dd>true if this resource is likely to be closeable.</dd>
-</dl>
-</section>
-</li>
-<li>
<section class="detail" id="isAlive()">
<h3>isAlive</h3>
<div class="member-signature"><span class="return-type">boolean</span> <span class="element-name">isAlive</span>()</div>
@@ -768,12 +742,19 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
<section class="detail" id="isSameResource(org.apache.datasketches.memory.Resource)">
<h3>isSameResource</h3>
<div class="member-signature"><span class="return-type">boolean</span> <span class="element-name">isSameResource</span><wbr><span class="parameters">(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</span></div>
-<div class="block">Returns true if the underlying resource is the same underlying resource as <i>that</i>.</div>
+<div class="block">Returns true if the underlying resource is the same resource as <i>that</i>.
+
+ <p>Two resources are considered the same if one were to write a value at offset A in one resource
+ and that same value appears in the other resource at the same offset A. In other words,
+ if two regions (or slices) are derived from the same underlying resource they both must have the same
+ starting offset with respect to the resource and the same size in order to be considered to be the same resource.</p>
+
+ <p>Note: for on-heap resources neither <i>this</i> nor <i>that</i> can be read-only.</p></div>
<dl class="notes">
<dt>Parameters:</dt>
-<dd><code>that</code> - the other Resource object</dd>
+<dd><code>that</code> - the other Resource.</dd>
<dt>Returns:</dt>
-<dd>a long value representing the ordering and size of overlap between <i>this</i> and <i>that</i></dd>
+<dd>true if the underlying resource is the same underlying resource as <i>that</i>.</dd>
</dl>
</section>
</li>
@@ -793,23 +774,6 @@ extends <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/ja
</section>
</li>
<li>
-<section class="detail" id="nativeOverlap(org.apache.datasketches.memory.Resource)">
-<h3>nativeOverlap</h3>
-<div class="member-signature"><span class="return-type">long</span> <span class="element-name">nativeOverlap</span><wbr><span class="parameters">(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</span></div>
-<div class="block">Returns a positive number if <i>this</i> overlaps <i>that</i> and <i>this</i> base address is ≤ <i>that</i>
- base address.
- Returns a negative number if <i>this</i> overlaps <i>that</i> and <i>this</i> base address is > <i>that</i>
- base address.
- Returns a zero if there is no overlap or if one or both objects are null, not active or on heap.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>that</code> - the other Resource object</dd>
-<dt>Returns:</dt>
-<dd>a long value representing the ordering and size of overlap between <i>this</i> and <i>that</i>.</dd>
-</dl>
-</section>
-</li>
-<li>
<section class="detail" id="mismatch(org.apache.datasketches.memory.Resource)">
<h3>mismatch</h3>
<div class="member-signature"><span class="return-type">long</span> <span class="element-name">mismatch</span><wbr><span class="parameters">(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</span></div>
@@ -861,6 +825,23 @@ mismatch(MemorySegment, long, long, MemorySegment, long, long)</a></li>
</section>
</li>
<li>
+<section class="detail" id="nativeOverlap(org.apache.datasketches.memory.Resource)">
+<h3>nativeOverlap</h3>
+<div class="member-signature"><span class="return-type">long</span> <span class="element-name">nativeOverlap</span><wbr><span class="parameters">(<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</span></div>
+<div class="block">Returns a positive number if <i>this</i> overlaps <i>that</i> and <i>this</i> base address is ≤ <i>that</i>
+ base address.
+ Returns a negative number if <i>this</i> overlaps <i>that</i> and <i>this</i> base address is > <i>that</i>
+ base address.
+ Returns a zero if there is no overlap or if one or both objects are null, not active or on heap.</div>
+<dl class="notes">
+<dt>Parameters:</dt>
+<dd><code>that</code> - the other Resource object</dd>
+<dt>Returns:</dt>
+<dd>a long value representing the ordering and size of overlap between <i>this</i> and <i>that</i>.</dd>
+</dl>
+</section>
+</li>
+<li>
<section class="detail" id="scope()">
<h3>scope</h3>
<div class="member-signature"><span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment.Scope</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.Scope.html#preview-java.lang.foreign.MemorySegment.Scope" title="class or interface in java.lang.foreign" class="external- [...]
@@ -887,13 +868,20 @@ mismatch(MemorySegment, long, long, MemorySegment, long, long)</a></li>
</section>
</li>
<li>
-<section class="detail" id="toMemorySegment()">
+<section class="detail" id="toMemorySegment(java.lang.foreign.Arena,long)">
<h3>toMemorySegment</h3>
-<div class="member-signature"><span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#preview-java.lang.foreign.MemorySegment" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup>< [...]
-<div class="block">Returns a copy of the underlying MemorySegment.</div>
+<div class="member-signature"><span class="return-type"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html" title="class or interface in java.lang.foreign" class="external-link">MemorySegment</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/MemorySegment.html#preview-java.lang.foreign.MemorySegment" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup>< [...]
+ long alignment)</span></div>
+<div class="block">Returns a copy of the underlying MemorySegment in the given arena.</div>
<dl class="notes">
+<dt>Parameters:</dt>
+<dd><code>arena</code> - the given arena.
+ If the desired result is to be off-heap, the arena must not be null.
+ Otherwise, the result will be on-heap.
+ Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
+<dd><code>alignment</code> - requested segment alignment. Typically 1, 2, 4 or 8.</dd>
<dt>Returns:</dt>
-<dd>a copy of the underlying MemorySegment.</dd>
+<dd>a copy of the underlying MemorySegment in the given arena.</dd>
</dl>
</section>
</li>
@@ -990,7 +978,7 @@ mismatch(MemorySegment, long, long, MemorySegment, long, long)</a></li>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/WritableBuffer.html b/docs/main/org/apache/datasketches/memory/WritableBuffer.html
index 3c1c0628..945565ab 100644
--- a/docs/main/org/apache/datasketches/memory/WritableBuffer.html
+++ b/docs/main/org/apache/datasketches/memory/WritableBuffer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>WritableBuffer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>WritableBuffer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: WritableBuffer">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -88,7 +88,7 @@ loadScripts(document, 'script');</script>
<section class="class-description" id="class-description">
<dl class="notes">
<dt>All Superinterfaces:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="Buffer.html" title="interface in org.apache.datasketches.memory">Buffer</a></code>, <code><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resour [...]
+<dd><code><a href="Buffer.html" title="interface in org.apache.datasketches.memory">Buffer</a></code>, <code><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
</dl>
<hr>
<div class="type-signature"><span class="modifiers">public interface </span><span class="element-name type-name-label">WritableBuffer</span><span class="extends-implements">
@@ -330,7 +330,7 @@ extends <a href="Buffer.html" title="interface in org.apache.datasketches.memory
<code><a href="Positional.html#getEnd()">getEnd</a>, <a href="Positional.html#getPosition()">getPosition</a>, <a href="Positional.html#getRemaining()">getRemaining</a>, <a href="Positional.html#getStart()">getStart</a>, <a href="Positional.html#hasRemaining()">hasRemaining</a>, <a href="Positional.html#incrementPosition(long)">incrementPosition</a>, <a href="Positional.html#resetPosition()">resetPosition</a>, <a href="Positional.html#setPosition(long)">setPosition</a>, <a href="Positiona [...]
<div class="inherited-list">
<h3 id="methods-inherited-from-class-org.apache.datasketches.memory.Resource">Methods inherited from interface org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></h3>
-<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#close()">close</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.ht [...]
+<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.html#getArena()">getArena</a>, <a href="Resou [...]
</section>
</li>
</ul>
@@ -871,7 +871,7 @@ extends <a href="Buffer.html" title="interface in org.apache.datasketches.memory
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/WritableMemory.html b/docs/main/org/apache/datasketches/memory/WritableMemory.html
index 8cfcb37e..947b1239 100644
--- a/docs/main/org/apache/datasketches/memory/WritableMemory.html
+++ b/docs/main/org/apache/datasketches/memory/WritableMemory.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>WritableMemory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>WritableMemory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, interface: WritableMemory">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -88,7 +88,7 @@ loadScripts(document, 'script');</script>
<section class="class-description" id="class-description">
<dl class="notes">
<dt>All Superinterfaces:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" title="class or interface in java.lang" class="external-link">AutoCloseable</a></code>, <code><a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
+<dd><code><a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></code>, <code><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></code></dd>
</dl>
<hr>
<div class="type-signature"><span class="modifiers">public interface </span><span class="element-name type-name-label">WritableMemory</span><span class="extends-implements">
@@ -147,21 +147,23 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<div class="block">Creates on-heap WritableMemory with the given capacity and the given byte order.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+ long alignmentBytes,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+ <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
- long alignmentBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
- <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#allocateDirect(long,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+ <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
@@ -322,19 +324,6 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<div class="block">Sets the bits defined by the bitMask</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableMap(java.io.File)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
-<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
-</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableMap(java.io.File,long,long,java.nio.ByteOrder)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
- long fileOffsetBytes,
- long capacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
-<div class="block">Maps the specified portion of the given file into Memory for write operations with Arena.ofConfined().</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
long fileOffsetBytes,
long capacityBytes,
@@ -343,87 +332,93 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Maps the specified portion of the given file into Memory for write operations.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#writableRegion(long,long)" class="member-name-link">writableRegion</a><wbr>(long offsetBytes,
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableMap(java.io.File,java.lang.foreign.Arena)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
+<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
+</div>
+<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code>default <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5"><code><a href="#writableRegion(long,long)" class="member-name-link">writableRegion</a><wbr>(long offsetBytes,
long capacityBytes)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
+<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab5">
<div class="block">A writable region is a writable view of this object.</div>
</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#writableRegion(long,long,java.nio.ByteOrder)" class="member-name-link">writableRegion</a><wbr>(long offsetBytes,
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3"><code><a href="#writableRegion(long,long,java.nio.ByteOrder)" class="member-name-link">writableRegion</a><wbr>(long offsetBytes,
long capacityBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab2 method-summary-table-tab3">
<div class="block">A writable region is a writable view of this object.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D)" class="member-name-link">writableWrap</a><wbr>(byte[] array)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
+<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D)" class="member-name-link">writableWrap</a><wbr>(byte[] array)</code></div>
+<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
int offsetBytes,
int lengthBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations with the given byte order.</div>
</div>
-<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
+<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
int offsetBytes,
int lengthBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
<a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
-<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
-<div class="block">Wraps the given primitive array for write operations with the given byte order.</div>
-</div>
-<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,java.nio.ByteOrder)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations with the given byte order.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(char%5B%5D)" class="member-name-link">writableWrap</a><wbr>(char[] array)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(byte%5B%5D,java.nio.ByteOrder)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
-<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
+<div class="block">Wraps the given primitive array for write operations with the given byte order.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(double%5B%5D)" class="member-name-link">writableWrap</a><wbr>(double[] array)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(char%5B%5D)" class="member-name-link">writableWrap</a><wbr>(char[] array)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(float%5B%5D)" class="member-name-link">writableWrap</a><wbr>(float[] array)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(double%5B%5D)" class="member-name-link">writableWrap</a><wbr>(double[] array)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(int%5B%5D)" class="member-name-link">writableWrap</a><wbr>(int[] array)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(float%5B%5D)" class="member-name-link">writableWrap</a><wbr>(float[] array)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(long%5B%5D)" class="member-name-link">writableWrap</a><wbr>(long[] array)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(int%5B%5D)" class="member-name-link">writableWrap</a><wbr>(int[] array)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(short%5B%5D)" class="member-name-link">writableWrap</a><wbr>(short[] array)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(long%5B%5D)" class="member-name-link">writableWrap</a><wbr>(long[] array)</code></div>
<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(java.nio.ByteBuffer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer)</code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(short%5B%5D)" class="member-name-link">writableWrap</a><wbr>(short[] array)</code></div>
<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
-<div class="block">Provides a view of the given <i>ByteBuffer</i> for write operations.</div>
+<div class="block">Wraps the given primitive array for write operations assuming native byte order.</div>
</div>
<div class="col-first even-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(java.nio.ByteBuffer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer)</code></div>
+<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
+<div class="block">Provides a view of the given <i>ByteBuffer</i> for write operations.</div>
+</div>
+<div class="col-first odd-row-color method-summary-table method-summary-table-tab1"><code>static <a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color method-summary-table method-summary-table-tab1"><code><a href="#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
<a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
-<div class="col-last even-row-color method-summary-table method-summary-table-tab1">
+<div class="col-last odd-row-color method-summary-table method-summary-table-tab1">
<div class="block">Provides a view of the given <i>ByteBuffer</i> for write operations.</div>
</div>
</div>
@@ -434,7 +429,7 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<code><a href="Memory.html#asBuffer()">asBuffer</a>, <a href="Memory.html#asBuffer(java.nio.ByteOrder)">asBuffer</a>, <a href="Memory.html#copyTo(long,org.apache.datasketches.memory.WritableMemory,long,long)">copyTo</a>, <a href="Memory.html#getBoolean(long)">getBoolean</a>, <a href="Memory.html#getByte(long)">getByte</a>, <a href="Memory.html#getByteArray(long,byte%5B%5D,int,int)">getByteArray</a>, <a href="Memory.html#getChar(long)">getChar</a>, <a href="Memory.html#getCharArray(long,c [...]
<div class="inherited-list">
<h3 id="methods-inherited-from-class-org.apache.datasketches.memory.Resource">Methods inherited from interface org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></h3>
-<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#close()">close</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.ht [...]
+<code><a href="Resource.html#asByteBufferView(java.nio.ByteOrder)">asByteBufferView</a>, <a href="Resource.html#compareTo(long,long,org.apache.datasketches.memory.Resource,long,long)">compareTo</a>, <a href="Resource.html#equalTo(long,org.apache.datasketches.memory.Resource,long,long)">equalTo</a>, <a href="Resource.html#equalTo(org.apache.datasketches.memory.Resource)">equalTo</a>, <a href="Resource.html#force()">force</a>, <a href="Resource.html#getArena()">getArena</a>, <a href="Resou [...]
</section>
</li>
</ul>
@@ -486,16 +481,19 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
</section>
</li>
<li>
-<section class="detail" id="writableMap(java.io.File)">
+<section class="detail" id="writableMap(java.io.File,java.lang.foreign.Arena)">
<h3>writableMap</h3>
-<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">writableMap</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file)</span>
+<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">writableMap</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</span>
throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></span></div>
<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().
Calling this method is equivalent to calling
- <a href="#writableMap(java.io.File,long,long,java.nio.ByteOrder)"><code>writableMap(file, 0, file.length(), ByteOrder.nativeOrder())</code></a>.</div>
+ <a href="#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)"><code>writableMap(file, 0, file.length(), ByteOrder.nativeOrder(), arena)</code></a><sup><a href="#preview-writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)">PREVIEW</a></sup>.</div>
<dl class="notes">
<dt>Parameters:</dt>
<dd><code>file</code> - the given file to map. It must be non-null and writable.</dd>
+<dd><code>arena</code> - the given arena to manage the new off-heap WritableMemory. It must be non-null.
+ Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
<dt>Returns:</dt>
<dd>a file-mapped WritableMemory</dd>
<dt>Throws:</dt>
@@ -507,34 +505,6 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
</section>
</li>
<li>
-<section class="detail" id="writableMap(java.io.File,long,long,java.nio.ByteOrder)">
-<h3>writableMap</h3>
-<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">writableMap</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
- long fileOffsetBytes,
- long capacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</span>
- throws <span class="exceptions"><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></span></div>
-<div class="block">Maps the specified portion of the given file into Memory for write operations with Arena.ofConfined().
- Calling this method is equivalent to calling
- <a href="#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)"><code>writableMap(file, fileOffsetBytes, capacityBytes, ByteOrder, Arena.ofConfined())</code></a><sup><a href="#preview-writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)">PREVIEW</a></sup>.</div>
-<dl class="notes">
-<dt>Parameters:</dt>
-<dd><code>file</code> - the given file to map. It must be non-null with a non-negative length and writable.</dd>
-<dd><code>fileOffsetBytes</code> - the position in the given file in bytes. It must not be negative.</dd>
-<dd><code>capacityBytes</code> - the size of the mapped Memory. It must be ≥ 0.</dd>
-<dd><code>byteOrder</code> - the byte order to be used. It must be non-null.</dd>
-<dt>Returns:</dt>
-<dd>mapped WritableMemory.</dd>
-<dt>Throws:</dt>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - -- if file is not readable or writable.</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - -- if file is not writable.</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/IOException.html" title="class or interface in java.io" class="external-link">IOException</a></code> - - if the specified path does not point to an existing file, or if some other I/O error occurs.</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/SecurityException.html" title="class or interface in java.lang" class="external-link">SecurityException</a></code> - - If a security manager is installed and it denies an unspecified permission
- required by the implementation.</dd>
-</dl>
-</section>
-</li>
-<li>
<section class="detail" id="writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)">
<h3>writableMap</h3>
<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">writableMap</span><wbr><span class="parameters">(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
@@ -550,7 +520,7 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<dd><code>fileOffsetBytes</code> - the position in the given file in bytes. It must not be negative.</dd>
<dd><code>capacityBytes</code> - the size of the mapped Memory.</dd>
<dd><code>byteOrder</code> - the given <i>ByteOrder</i>. It must be non-null.</dd>
-<dd><code>arena</code> - the given arena to map. It must be non-null.
+<dd><code>arena</code> - the given arena to manage the new off-heap WritableMemory. It must be non-null.
Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
<dt>Returns:</dt>
<dd>a file-mapped WritableMemory.</dd>
@@ -563,47 +533,48 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
</section>
</li>
<li>
-<section class="detail" id="allocateDirect(long)">
+<section class="detail" id="allocateDirect(long,java.lang.foreign.Arena)">
<h3>allocateDirect</h3>
-<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">allocateDirect</span><wbr><span class="parameters">(long capacityBytes)</span></div>
+<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">allocateDirect</span><wbr><span class="parameters">(long capacityBytes,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</span></div>
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.
The allocated memory will be 8-byte aligned.
Native byte order is assumed.
- A new DefaultMemoryRequestServer() is created.
- A new Arena.ofConfined() is created.
+ A new DefaultMemoryRequestServer() is created, which allocates on-heap.
- <p><b>NOTE:</b> Native/Direct memory acquired may have garbage in it.
- It is the responsibility of the using application to clear this memory, if required,
- and to call <i>close()</i> when done.</p></div>
+ <p><b>NOTE:</b>It is the responsibility of the using application to call
+ <i>WritableMemory::getArena().close()</i> when done.</p></div>
<dl class="notes">
<dt>Parameters:</dt>
-<dd><code>capacityBytes</code> - the size of the desired memory in bytes.
- Warning: This class is not thread-safe.</dd>
+<dd><code>capacityBytes</code> - the size of the desired memory in bytes.</dd>
+<dd><code>arena</code> - the given arena to manage the new off-heap WritableMemory. It must be non-null.
+ Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
<dt>Returns:</dt>
-<dd>WritableMemory for this off-heap, native resource.</dd>
+<dd>a WritableMemory for this off-heap resource.</dd>
</dl>
</section>
</li>
<li>
-<section class="detail" id="allocateDirect(long,java.lang.foreign.Arena)">
+<section class="detail" id="allocateDirect(long,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)">
<h3>allocateDirect</h3>
<div class="member-signature"><span class="modifiers">static</span> <span class="return-type"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></span> <span class="element-name">allocateDirect</span><wbr><span class="parameters">(long capacityBytes,
+ <a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</span></div>
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.
The allocated memory will be 8-byte aligned.
Native byte order is assumed.
- A new DefaultMemoryRequestServer() is created.
- <p><b>NOTE:</b> Native/Direct memory acquired may have garbage in it.
- It is the responsibility of the using application to clear this memory, if required,
- and to call <i>close()</i> when done.</p></div>
+ <p><b>NOTE:</b>It is the responsibility of the using application to call
+ <i>WritableMemory::getArena().close()</i> when done.</p></div>
<dl class="notes">
<dt>Parameters:</dt>
<dd><code>capacityBytes</code> - the size of the desired memory in bytes.</dd>
-<dd><code>arena</code> - the given arena to use. It must be non-null.
+<dd><code>memReqSvr</code> - A user-specified MemoryRequestServer, which may be null.
+ This is a callback mechanism for a user client of direct memory to request more memory.</dd>
+<dd><code>arena</code> - the given arena to manage the new off-heap WritableMemory. It must be non-null.
Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
<dt>Returns:</dt>
-<dd>WritableMemory for this off-heap, native resource.</dd>
+<dd>a WritableMemory for this off-heap resource.</dd>
</dl>
</section>
</li>
@@ -628,7 +599,7 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
<dd><code>byteOrder</code> - the given <i>ByteOrder</i>. It must be non-null.</dd>
<dd><code>memReqSvr</code> - A user-specified MemoryRequestServer, which may be null.
This is a callback mechanism for a user client of direct memory to request more memory.</dd>
-<dd><code>arena</code> - the given arena to use. It must be non-null.
+<dd><code>arena</code> - the given arena to manage the new off-heap WritableMemory. It must be non-null.
Warning: This class is not thread-safe. Specifying an Arena that allows multiple threads is not recommended.</dd>
<dt>Returns:</dt>
<dd>a WritableMemory for this off-heap resource.</dd>
@@ -1243,7 +1214,7 @@ extends <a href="Memory.html" title="interface in org.apache.datasketches.memory
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/XxHash.html b/docs/main/org/apache/datasketches/memory/XxHash.html
index a0f3e785..6c55edea 100644
--- a/docs/main/org/apache/datasketches/memory/XxHash.html
+++ b/docs/main/org/apache/datasketches/memory/XxHash.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>XxHash (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>XxHash (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory, class: XxHash">
<meta name="generator" content="javadoc/ClassWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -404,7 +404,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/Buffer.html b/docs/main/org/apache/datasketches/memory/class-use/Buffer.html
index 7c8814f2..c997fe0e 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/Buffer.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/Buffer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.Buffer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.Buffer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: Buffer">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -128,7 +128,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/BufferPositionInvariantsException.html b/docs/main/org/apache/datasketches/memory/class-use/BufferPositionInvariantsException.html
index 391d4245..bf1f6043 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/BufferPositionInvariantsException.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/BufferPositionInvariantsException.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Class org.apache.datasketches.memory.BufferPositionInvariantsException (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Class org.apache.datasketches.memory.BufferPositionInvariantsException (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, class: BufferPositionInvariantsException">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -53,7 +53,7 @@ loadScripts(document, 'script');</script>
No usage of org.apache.datasketches.memory.BufferPositionInvariantsException</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/DefaultMemoryRequestServer.html b/docs/main/org/apache/datasketches/memory/class-use/DefaultMemoryRequestServer.html
index 950dd3bf..fdd0c6ce 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/DefaultMemoryRequestServer.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/DefaultMemoryRequestServer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Class org.apache.datasketches.memory.DefaultMemoryRequestServer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Class org.apache.datasketches.memory.DefaultMemoryRequestServer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, class: DefaultMemoryRequestServer">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -53,7 +53,7 @@ loadScripts(document, 'script');</script>
No usage of org.apache.datasketches.memory.DefaultMemoryRequestServer</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/Memory.html b/docs/main/org/apache/datasketches/memory/class-use/Memory.html
index 7eeaef1f..88a3ea93 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/Memory.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/Memory.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.Memory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.Memory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: Memory">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -172,21 +172,6 @@ loadScripts(document, 'script');</script>
<div class="block">Provides a view of the given <i>ByteBuffer</i> for read-only operations.</div>
</div>
</div>
-<div class="caption"><span>Methods in <a href="../package-summary.html">org.apache.datasketches.memory</a> with parameters of type <a href="../Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></span></div>
-<div class="summary-table three-column-summary">
-<div class="table-header col-first">Modifier and Type</div>
-<div class="table-header col-second">Method</div>
-<div class="table-header col-last">Description</div>
-<div class="col-first even-row-color"><code>static long[]</code></div>
-<div class="col-second even-row-color"><span class="type-name-label">MurmurHash3.</span><code><a href="../MurmurHash3.html#hash(org.apache.datasketches.memory.Memory,long,long,long,long%5B%5D)" class="member-name-link">hash</a><wbr>(<a href="../Memory.html" title="interface in org.apache.datasketches.memory">Memory</a> mem,
- long offsetBytes,
- long lengthBytes,
- long seed,
- long[] hashOut)</code></div>
-<div class="col-last even-row-color">
-<div class="block">Returns a 128-bit hash of the input as a long array of size 2.</div>
-</div>
-</div>
</section>
</li>
</ul>
@@ -194,7 +179,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/MemoryRequestServer.html b/docs/main/org/apache/datasketches/memory/class-use/MemoryRequestServer.html
index 0021c8c2..a555bbfd 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/MemoryRequestServer.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/MemoryRequestServer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.MemoryRequestServer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.MemoryRequestServer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: MemoryRequestServer">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -64,7 +64,7 @@ loadScripts(document, 'script');</script>
<div class="col-second even-row-color"><code><a href="../DefaultMemoryRequestServer.html" class="type-name-link" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></code></div>
<div class="col-last even-row-color">
<div class="block">This example MemoryRequestServer is simple but demonstrates one of many ways to
- manage continuous requests for larger memory.</div>
+ manage continuous requests for larger or smaller memory.</div>
</div>
</div>
<div class="caption"><span>Fields in <a href="../package-summary.html">org.apache.datasketches.memory</a> declared as <a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></span></div>
@@ -111,33 +111,40 @@ loadScripts(document, 'script');</script>
<div class="col-last odd-row-color">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</div>
-<div class="col-first even-row-color"><code>void</code></div>
-<div class="col-second even-row-color"><span class="type-name-label">Resource.</span><code><a href="../Resource.html#setMemoryRequestServer(org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">setMemoryRequestServer</a><wbr>(<a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
+<div class="col-first even-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+ <a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last even-row-color">
+<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
+</div>
+<div class="col-first odd-row-color"><code>void</code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">Resource.</span><code><a href="../Resource.html#setMemoryRequestServer(org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">setMemoryRequestServer</a><wbr>(<a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
+<div class="col-last odd-row-color">
<div class="block">Sets the MemoryRequestServer to be used in case of capacity overflow of on-heap or off-heap
allocated Memory.</div>
</div>
-<div class="col-first odd-row-color"><code>static <a href="../WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableBuffer.</span><code><a href="../WritableBuffer.html#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
+<div class="col-first even-row-color"><code>static <a href="../WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></code></div>
+<div class="col-second even-row-color"><span class="type-name-label">WritableBuffer.</span><code><a href="../WritableBuffer.html#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
<a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
-<div class="col-last odd-row-color">
+<div class="col-last even-row-color">
<div class="block">Provides a view of the given <i>ByteBuffer</i> for write operations.</div>
</div>
-<div class="col-first even-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
+<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableWrap(byte%5B%5D,int,int,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(byte[] array,
int offsetBytes,
int lengthBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
<a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
-<div class="col-last even-row-color">
+<div class="col-last odd-row-color">
<div class="block">Wraps the given primitive array for write operations with the given byte order.</div>
</div>
-<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
+<div class="col-first even-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableWrap(java.nio.ByteBuffer,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer)" class="member-name-link">writableWrap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteBuffer.html" title="class or interface in java.nio" class="external-link">ByteBuffer</a> byteBuffer,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
<a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr)</code></div>
-<div class="col-last odd-row-color">
+<div class="col-last even-row-color">
<div class="block">Provides a view of the given <i>ByteBuffer</i> for write operations.</div>
</div>
</div>
@@ -148,7 +155,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/MurmurHash3.html b/docs/main/org/apache/datasketches/memory/class-use/MurmurHash3.html
deleted file mode 100644
index e3476039..00000000
--- a/docs/main/org/apache/datasketches/memory/class-use/MurmurHash3.html
+++ /dev/null
@@ -1,61 +0,0 @@
-<!DOCTYPE HTML>
-<html lang>
-<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Class org.apache.datasketches.memory.MurmurHash3 (datasketches-memory 5.0.0-SNAPSHOT API)</title>
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
-<meta name="description" content="use: package: org.apache.datasketches.memory, class: MurmurHash3">
-<meta name="generator" content="javadoc/ClassUseWriter">
-<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
-<link rel="stylesheet" type="text/css" href="../../../../../script-dir/jquery-ui.min.css" title="Style">
-<script type="text/javascript" src="../../../../../script.js"></script>
-<script type="text/javascript" src="../../../../../script-dir/jquery-3.7.1.min.js"></script>
-<script type="text/javascript" src="../../../../../script-dir/jquery-ui.min.js"></script>
-</head>
-<body class="class-use-page">
-<script type="text/javascript">var pathtoroot = "../../../../../";
-loadScripts(document, 'script');</script>
-<noscript>
-<div>JavaScript is disabled on your browser.</div>
-</noscript>
-<div class="flex-box">
-<header role="banner" class="flex-header">
-<nav role="navigation">
-<!-- ========= START OF TOP NAVBAR ======= -->
-<div class="top-nav" id="navbar-top"><button id="navbar-toggle-button" aria-controls="navbar-top" aria-expanded="false" aria-label="Toggle navigation links"><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span><span class="nav-bar-toggle-icon"> </span></button>
-<div class="skip-nav"><a href="#skip-navbar-top" title="Skip navigation links">Skip navigation links</a></div>
-<ul id="navbar-top-firstrow" class="nav-list" title="Navigation">
-<li><a href="../package-summary.html">Package</a></li>
-<li><a href="../MurmurHash3.html" title="class in org.apache.datasketches.memory">Class</a></li>
-<li class="nav-bar-cell1-rev">Use</li>
-<li><a href="../package-tree.html">Tree</a></li>
-<li><a href="../../../../../index-all.html">Index</a></li>
-<li><a href="../../../../../help-doc.html#use">Help</a></li>
-</ul>
-</div>
-<div class="sub-nav">
-<div id="navbar-sub-list"></div>
-<div class="nav-list-search"><a href="../../../../../search.html">SEARCH</a>
-<input type="text" id="search-input" disabled placeholder="Search">
-<input type="reset" id="reset-button" disabled value="reset">
-</div>
-</div>
-<!-- ========= END OF TOP NAVBAR ========= -->
-<span class="skip-nav" id="skip-navbar-top"></span></nav>
-</header>
-<div class="flex-content">
-<main role="main">
-<div class="header">
-<h1 title="Uses of Class org.apache.datasketches.memory.MurmurHash3" class="title">Uses of Class<br>org.apache.datasketches.memory.MurmurHash3</h1>
-</div>
-No usage of org.apache.datasketches.memory.MurmurHash3</main>
-<footer role="contentinfo">
-<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
-</footer>
-</div>
-</div>
-</body>
-</html>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/Positional.html b/docs/main/org/apache/datasketches/memory/class-use/Positional.html
index bdfa9303..44cc9465 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/Positional.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/Positional.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.Positional (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.Positional (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: Positional">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -107,7 +107,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/Resource.html b/docs/main/org/apache/datasketches/memory/class-use/Resource.html
index 4a71bdac..d8689d42 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/Resource.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/Resource.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.Resource (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.Resource (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: Resource">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -113,12 +113,13 @@ loadScripts(document, 'script');</script>
<div class="col-first odd-row-color"><code>long</code></div>
<div class="col-second odd-row-color"><span class="type-name-label">Resource.</span><code><a href="../Resource.html#getRelativeOffset(org.apache.datasketches.memory.Resource)" class="member-name-link">getRelativeOffset</a><wbr>(<a href="../Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
<div class="col-last odd-row-color">
-<div class="block">Gets the relative base offset of <i>this</i> with respect to <i>that</i>, defined as: <i>this</i> - <i>that</i>.</div>
+<div class="block">Gets the relative base offset of <i>this</i> resource with respect to <i>that</i> resource,
+ defined as: <i>this</i> - <i>that</i>.</div>
</div>
<div class="col-first even-row-color"><code>boolean</code></div>
<div class="col-second even-row-color"><span class="type-name-label">Resource.</span><code><a href="../Resource.html#isSameResource(org.apache.datasketches.memory.Resource)" class="member-name-link">isSameResource</a><wbr>(<a href="../Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
<div class="col-last even-row-color">
-<div class="block">Returns true if the underlying resource is the same underlying resource as <i>that</i>.</div>
+<div class="block">Returns true if the underlying resource is the same resource as <i>that</i>.</div>
</div>
<div class="col-first odd-row-color"><code>long</code></div>
<div class="col-second odd-row-color"><span class="type-name-label">Resource.</span><code><a href="../Resource.html#mismatch(org.apache.datasketches.memory.Resource)" class="member-name-link">mismatch</a><wbr>(<a href="../Resource.html" title="interface in org.apache.datasketches.memory">Resource</a> that)</code></div>
@@ -149,7 +150,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/WritableBuffer.html b/docs/main/org/apache/datasketches/memory/class-use/WritableBuffer.html
index e76ed7b2..b3f788ce 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/WritableBuffer.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/WritableBuffer.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.WritableBuffer (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.WritableBuffer (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: WritableBuffer">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -115,7 +115,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/WritableMemory.html b/docs/main/org/apache/datasketches/memory/class-use/WritableMemory.html
index 9cd58ded..f703d0bf 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/WritableMemory.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/WritableMemory.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Interface org.apache.datasketches.memory.WritableMemory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Interface org.apache.datasketches.memory.WritableMemory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, interface: WritableMemory">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -79,21 +79,23 @@ loadScripts(document, 'script');</script>
<div class="block">Creates on-heap WritableMemory with the given capacity and the given byte order.</div>
</div>
<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes)</code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+ long alignmentBytes,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+ <a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last odd-row-color">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</div>
<div class="col-first even-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,long,java.nio.ByteOrder,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
- long alignmentBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
- <a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
+<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last even-row-color">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
</div>
<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#allocateDirect(long,org.apache.datasketches.memory.MemoryRequestServer,java.lang.foreign.Arena)" class="member-name-link">allocateDirect</a><wbr>(long capacityBytes,
+ <a href="../MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a> memReqSvr,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last odd-row-color">
<div class="block">Allocates and provides access to capacityBytes directly in native (off-heap) memory.</div>
@@ -109,44 +111,29 @@ loadScripts(document, 'script');</script>
<div class="block">Convert this WritableBuffer to a WritableMemory with the given byte order.</div>
</div>
<div class="col-first even-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWmem,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
+<div class="col-second even-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
+ long newCapacityBytes)</code></div>
<div class="col-last even-row-color"> </div>
-<div class="col-first odd-row-color"><code>default <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
+<div class="col-first odd-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
long newCapacityBytes)</code></div>
<div class="col-last odd-row-color">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first even-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
-<div class="col-last even-row-color">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableMap(java.io.File)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file)</code></div>
-<div class="col-last odd-row-color">
-<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
</div>
<div class="col-first even-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableMap(java.io.File,long,long,java.nio.ByteOrder)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
+<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
long fileOffsetBytes,
long capacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder)</code></div>
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+ <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last even-row-color">
-<div class="block">Maps the specified portion of the given file into Memory for write operations with Arena.ofConfined().</div>
+<div class="block">Maps the specified portion of the given file into Memory for write operations.</div>
</div>
<div class="col-first odd-row-color"><code>static <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableMap(java.io.File,long,long,java.nio.ByteOrder,java.lang.foreign.Arena)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
- long fileOffsetBytes,
- long capacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/nio/ByteOrder.html" title="class or interface in java.nio" class="external-link">ByteOrder</a> byteOrder,
+<div class="col-second odd-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableMap(java.io.File,java.lang.foreign.Arena)" class="member-name-link">writableMap</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/File.html" title="class or interface in java.io" class="external-link">File</a> file,
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
<div class="col-last odd-row-color">
-<div class="block">Maps the specified portion of the given file into Memory for write operations.</div>
+<div class="block">Maps the entire given file into native-ordered WritableMemory for write operations with Arena.ofConfined().</div>
</div>
<div class="col-first even-row-color"><code>default <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
<div class="col-second even-row-color"><span class="type-name-label">WritableMemory.</span><code><a href="../WritableMemory.html#writableRegion(long,long)" class="member-name-link">writableRegion</a><wbr>(long offsetBytes,
@@ -248,37 +235,22 @@ loadScripts(document, 'script');</script>
<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/System.html#arraycopy(java.lang.Object,int,java.lang.Object,int,int)" title="class or interface in java.lang" class="external-link"><code>System.arraycopy(Object, int, Object, int, int)</code></a> has.</div>
</div>
<div class="col-first odd-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWmem,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
+ long newCapacityBytes)</code></div>
<div class="col-last odd-row-color"> </div>
-<div class="col-first even-row-color"><code>default <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second even-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
+<div class="col-first even-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
+<div class="col-second even-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> oldWmem,
long newCapacityBytes)</code></div>
<div class="col-last even-row-color">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first odd-row-color"><code><a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#request(org.apache.datasketches.memory.WritableMemory,long,java.lang.foreign.Arena)" class="member-name-link">request</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> currentWritableMemory,
- long newCapacityBytes,
- <a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html" title="class or interface in java.lang.foreign" class="external-link">Arena</a><sup><a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/foreign/Arena.html#preview-java.lang.foreign.Arena" title="class or interface in java.lang.foreign" class="external-link">PREVIEW</a></sup> arena)</code></div>
-<div class="col-last odd-row-color">
-<div class="block">Request new WritableMemory with the given newCapacityBytes.</div>
-</div>
-<div class="col-first even-row-color"><code>void</code></div>
-<div class="col-second even-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</code></div>
-<div class="col-last even-row-color"> </div>
-<div class="col-first odd-row-color"><code>default void</code></div>
-<div class="col-second odd-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose)</code></div>
-<div class="col-last odd-row-color">
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="block">Request a new WritableMemory with the given newCapacityBytes.</div>
</div>
+<div class="col-first odd-row-color"><code>void</code></div>
+<div class="col-second odd-row-color"><span class="type-name-label">DefaultMemoryRequestServer.</span><code><a href="../DefaultMemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</code></div>
+<div class="col-last odd-row-color"> </div>
<div class="col-first even-row-color"><code>void</code></div>
-<div class="col-second even-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory,org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> memToClose,
- <a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> newMemory)</code></div>
+<div class="col-second even-row-color"><span class="type-name-label">MemoryRequestServer.</span><code><a href="../MemoryRequestServer.html#requestClose(org.apache.datasketches.memory.WritableMemory)" class="member-name-link">requestClose</a><wbr>(<a href="../WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a> wmemToClose)</code></div>
<div class="col-last even-row-color">
-<div class="block">Request to close the resource, if applicable.</div>
+<div class="block">Request to close the given WritableMemory.</div>
</div>
</div>
</section>
@@ -288,7 +260,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/class-use/XxHash.html b/docs/main/org/apache/datasketches/memory/class-use/XxHash.html
index 6dbcd5c8..1882c669 100644
--- a/docs/main/org/apache/datasketches/memory/class-use/XxHash.html
+++ b/docs/main/org/apache/datasketches/memory/class-use/XxHash.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Class org.apache.datasketches.memory.XxHash (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Class org.apache.datasketches.memory.XxHash (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory, class: XxHash">
<meta name="generator" content="javadoc/ClassUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
@@ -53,7 +53,7 @@ loadScripts(document, 'script');</script>
No usage of org.apache.datasketches.memory.XxHash</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/package-summary.html b/docs/main/org/apache/datasketches/memory/package-summary.html
index 9be7de29..dc272334 100644
--- a/docs/main/org/apache/datasketches/memory/package-summary.html
+++ b/docs/main/org/apache/datasketches/memory/package-summary.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>org.apache.datasketches.memory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>org.apache.datasketches.memory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="declaration: package: org.apache.datasketches.memory">
<meta name="generator" content="javadoc/PackageWriterImpl">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -173,7 +173,7 @@ loadScripts(document, 'script');</script>
<div class="col-first even-row-color class-summary class-summary-tab2"><a href="DefaultMemoryRequestServer.html" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a></div>
<div class="col-last even-row-color class-summary class-summary-tab2">
<div class="block">This example MemoryRequestServer is simple but demonstrates one of many ways to
- manage continuous requests for larger memory.</div>
+ manage continuous requests for larger or smaller memory.</div>
</div>
<div class="col-first odd-row-color class-summary class-summary-tab1"><a href="Memory.html" title="interface in org.apache.datasketches.memory">Memory</a></div>
<div class="col-last odd-row-color class-summary class-summary-tab1">
@@ -181,32 +181,27 @@ loadScripts(document, 'script');</script>
</div>
<div class="col-first even-row-color class-summary class-summary-tab1"><a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></div>
<div class="col-last even-row-color class-summary class-summary-tab1">
-<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more memory
+<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more or less memory
for heap and off-heap WritableMemory resources that are not file-memory-mapped backed resources.</div>
</div>
-<div class="col-first odd-row-color class-summary class-summary-tab2"><a href="MurmurHash3.html" title="class in org.apache.datasketches.memory">MurmurHash3</a></div>
-<div class="col-last odd-row-color class-summary class-summary-tab2">
-<div class="block">The MurmurHash3 is a fast, non-cryptographic, 128-bit hash function that has
- excellent avalanche and 2-way bit independence properties.</div>
-</div>
-<div class="col-first even-row-color class-summary class-summary-tab1"><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></div>
-<div class="col-last even-row-color class-summary class-summary-tab1">
+<div class="col-first odd-row-color class-summary class-summary-tab1"><a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a></div>
+<div class="col-last odd-row-color class-summary class-summary-tab1">
<div class="block">Defines the relative positional API.</div>
</div>
-<div class="col-first odd-row-color class-summary class-summary-tab1"><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></div>
-<div class="col-last odd-row-color class-summary class-summary-tab1">
+<div class="col-first even-row-color class-summary class-summary-tab1"><a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a></div>
+<div class="col-last even-row-color class-summary class-summary-tab1">
<div class="block">The base class for Memory and Buffer plus some common static variables and check methods.</div>
</div>
-<div class="col-first even-row-color class-summary class-summary-tab1"><a href="WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></div>
-<div class="col-last even-row-color class-summary class-summary-tab1">
+<div class="col-first odd-row-color class-summary class-summary-tab1"><a href="WritableBuffer.html" title="interface in org.apache.datasketches.memory">WritableBuffer</a></div>
+<div class="col-last odd-row-color class-summary class-summary-tab1">
<div class="block">Defines the writable API for relative positional access to a resource</div>
</div>
-<div class="col-first odd-row-color class-summary class-summary-tab1"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></div>
-<div class="col-last odd-row-color class-summary class-summary-tab1">
+<div class="col-first even-row-color class-summary class-summary-tab1"><a href="WritableMemory.html" title="interface in org.apache.datasketches.memory">WritableMemory</a></div>
+<div class="col-last even-row-color class-summary class-summary-tab1">
<div class="block">Defines the writable API for offset access to a resource.</div>
</div>
-<div class="col-first even-row-color class-summary class-summary-tab2"><a href="XxHash.html" title="class in org.apache.datasketches.memory">XxHash</a></div>
-<div class="col-last even-row-color class-summary class-summary-tab2">
+<div class="col-first odd-row-color class-summary class-summary-tab2"><a href="XxHash.html" title="class in org.apache.datasketches.memory">XxHash</a></div>
+<div class="col-last odd-row-color class-summary class-summary-tab2">
<div class="block">The XxHash is a fast, non-cryptographic, 64-bit hash function that has
excellent avalanche and 2-way bit independence properties.</div>
</div>
@@ -219,7 +214,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/package-tree.html b/docs/main/org/apache/datasketches/memory/package-tree.html
index 24546836..a7c2cf53 100644
--- a/docs/main/org/apache/datasketches/memory/package-tree.html
+++ b/docs/main/org/apache/datasketches/memory/package-tree.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>org.apache.datasketches.memory Class Hierarchy (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>org.apache.datasketches.memory Class Hierarchy (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="tree: package: org.apache.datasketches.memory">
<meta name="generator" content="javadoc/PackageTreeWriter">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -56,7 +56,6 @@ loadScripts(document, 'script');</script>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" class="type-name-link external-link" title="class or interface in java.lang">Object</a>
<ul>
<li class="circle">org.apache.datasketches.memory.<a href="DefaultMemoryRequestServer.html" class="type-name-link" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a> (implements org.apache.datasketches.memory.<a href="MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a>)</li>
-<li class="circle">org.apache.datasketches.memory.<a href="MurmurHash3.html" class="type-name-link" title="class in org.apache.datasketches.memory">MurmurHash3</a></li>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html" class="type-name-link external-link" title="class or interface in java.lang">Throwable</a> (implements java.io.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Serializable.html" title="class or interface in java.io" class="external-link">Serializable</a>)
<ul>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html" class="type-name-link external-link" title="class or interface in java.lang">Exception</a>
@@ -78,8 +77,16 @@ loadScripts(document, 'script');</script>
<section class="hierarchy">
<h2 title="Interface Hierarchy">Interface Hierarchy</h2>
<ul>
-<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" class="type-name-link external-link" title="class or interface in java.lang">AutoCloseable</a>
+<li class="circle">org.apache.datasketches.memory.<a href="MemoryRequestServer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></li>
+<li class="circle">org.apache.datasketches.memory.<a href="Positional.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Positional</a>
+<ul>
+<li class="circle">org.apache.datasketches.memory.<a href="Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a>)
<ul>
+<li class="circle">org.apache.datasketches.memory.<a href="WritableBuffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">WritableBuffer</a></li>
+</ul>
+</li>
+</ul>
+</li>
<li class="circle">org.apache.datasketches.memory.<a href="Resource.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Resource</a>
<ul>
<li class="circle">org.apache.datasketches.memory.<a href="Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="Positional.html" title="interface in org.apache.datasketches.memory">Positional</a>)
@@ -95,23 +102,11 @@ loadScripts(document, 'script');</script>
</ul>
</li>
</ul>
-</li>
-<li class="circle">org.apache.datasketches.memory.<a href="MemoryRequestServer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></li>
-<li class="circle">org.apache.datasketches.memory.<a href="Positional.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Positional</a>
-<ul>
-<li class="circle">org.apache.datasketches.memory.<a href="Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="Resource.html" title="interface in org.apache.datasketches.memory">Resource</a>)
-<ul>
-<li class="circle">org.apache.datasketches.memory.<a href="WritableBuffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">WritableBuffer</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
</section>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/org/apache/datasketches/memory/package-use.html b/docs/main/org/apache/datasketches/memory/package-use.html
index ae160981..987740c7 100644
--- a/docs/main/org/apache/datasketches/memory/package-use.html
+++ b/docs/main/org/apache/datasketches/memory/package-use.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Uses of Package org.apache.datasketches.memory (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Uses of Package org.apache.datasketches.memory (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="use: package: org.apache.datasketches.memory">
<meta name="generator" content="javadoc/PackageUseWriter">
<link rel="stylesheet" type="text/css" href="../../../../stylesheet.css" title="Style">
@@ -68,7 +68,7 @@ loadScripts(document, 'script');</script>
</div>
<div class="col-first even-row-color"><a href="class-use/MemoryRequestServer.html#org.apache.datasketches.memory">MemoryRequestServer</a></div>
<div class="col-last even-row-color">
-<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more memory
+<div class="block">The MemoryRequestServer is a callback interface to provide a means to request more or less memory
for heap and off-heap WritableMemory resources that are not file-memory-mapped backed resources.</div>
</div>
<div class="col-first odd-row-color"><a href="class-use/Positional.html#org.apache.datasketches.memory">Positional</a></div>
@@ -95,7 +95,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/overview-tree.html b/docs/main/overview-tree.html
index 26fd0b32..e836e140 100644
--- a/docs/main/overview-tree.html
+++ b/docs/main/overview-tree.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Class Hierarchy (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Class Hierarchy (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="class tree">
<meta name="generator" content="javadoc/TreeWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -60,7 +60,6 @@ loadScripts(document, 'script');</script>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Object.html" class="type-name-link external-link" title="class or interface in java.lang">Object</a>
<ul>
<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/DefaultMemoryRequestServer.html" class="type-name-link" title="class in org.apache.datasketches.memory">DefaultMemoryRequestServer</a> (implements org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a>)</li>
-<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MurmurHash3.html" class="type-name-link" title="class in org.apache.datasketches.memory">MurmurHash3</a></li>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Throwable.html" class="type-name-link external-link" title="class or interface in java.lang">Throwable</a> (implements java.io.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/io/Serializable.html" title="class or interface in java.io" class="external-link">Serializable</a>)
<ul>
<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/Exception.html" class="type-name-link external-link" title="class or interface in java.lang">Exception</a>
@@ -82,8 +81,16 @@ loadScripts(document, 'script');</script>
<section class="hierarchy">
<h2 title="Interface Hierarchy">Interface Hierarchy</h2>
<ul>
-<li class="circle">java.lang.<a href="https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/lang/AutoCloseable.html" class="type-name-link external-link" title="class or interface in java.lang">AutoCloseable</a>
+<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></li>
+<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Positional</a>
+<ul>
+<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a>)
<ul>
+<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableBuffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">WritableBuffer</a></li>
+</ul>
+</li>
+</ul>
+</li>
<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Resource</a>
<ul>
<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" title="interface in org.apache.datasketches.memory">Positional</a>)
@@ -99,23 +106,11 @@ loadScripts(document, 'script');</script>
</ul>
</li>
</ul>
-</li>
-<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/MemoryRequestServer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">MemoryRequestServer</a></li>
-<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Positional.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Positional</a>
-<ul>
-<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Buffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">Buffer</a> (also extends org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/Resource.html" title="interface in org.apache.datasketches.memory">Resource</a>)
-<ul>
-<li class="circle">org.apache.datasketches.memory.<a href="org/apache/datasketches/memory/WritableBuffer.html" class="type-name-link" title="interface in org.apache.datasketches.memory">WritableBuffer</a></li>
-</ul>
-</li>
-</ul>
-</li>
-</ul>
</section>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/search.html b/docs/main/search.html
index 9087e128..64b9665b 100644
--- a/docs/main/search.html
+++ b/docs/main/search.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Search (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Search (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="search">
<meta name="generator" content="javadoc/SearchWriter">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -68,7 +68,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/serialized-form.html b/docs/main/serialized-form.html
index fc06ac73..ce53a759 100644
--- a/docs/main/serialized-form.html
+++ b/docs/main/serialized-form.html
@@ -1,11 +1,11 @@
<!DOCTYPE HTML>
<html lang>
<head>
-<!-- Generated by javadoc (21) on Tue Dec 10 16:12:41 UTC 2024 -->
-<title>Serialized Form (datasketches-memory 5.0.0-SNAPSHOT API)</title>
+<!-- Generated by javadoc (21) on Tue Feb 18 19:33:30 UTC 2025 -->
+<title>Serialized Form (datasketches-memory 6.1.0-SNAPSHOT API)</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
-<meta name="dc.created" content="2024-12-10">
+<meta name="dc.created" content="2025-02-18">
<meta name="description" content="serialized forms">
<meta name="generator" content="javadoc/SerializedFormWriterImpl">
<link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
@@ -72,7 +72,7 @@ loadScripts(document, 'script');</script>
</main>
<footer role="contentinfo">
<hr>
-<p class="legal-copy"><small>Copyright © 2015–2024. All rights reserved.</small></p>
+<p class="legal-copy"><small>Copyright © 2015–2025. All rights reserved.</small></p>
</footer>
</div>
</div>
diff --git a/docs/main/type-search-index.js b/docs/main/type-search-index.js
index 91216f16..f1b021ea 100644
--- a/docs/main/type-search-index.js
+++ b/docs/main/type-search-index.js
@@ -1 +1 @@
-typeSearchIndex = [{"l":"All Classes and Interfaces","u":"allclasses-index.html"},{"p":"org.apache.datasketches.memory","l":"Buffer"},{"p":"org.apache.datasketches.memory","l":"BufferPositionInvariantsException"},{"p":"org.apache.datasketches.memory","l":"DefaultMemoryRequestServer"},{"p":"org.apache.datasketches.memory","l":"Memory"},{"p":"org.apache.datasketches.memory","l":"MemoryRequestServer"},{"p":"org.apache.datasketches.memory","l":"MurmurHash3"},{"p":"org.apache.datasketches.mem [...]
\ No newline at end of file
+typeSearchIndex = [{"l":"All Classes and Interfaces","u":"allclasses-index.html"},{"p":"org.apache.datasketches.memory","l":"Buffer"},{"p":"org.apache.datasketches.memory","l":"BufferPositionInvariantsException"},{"p":"org.apache.datasketches.memory","l":"DefaultMemoryRequestServer"},{"p":"org.apache.datasketches.memory","l":"Memory"},{"p":"org.apache.datasketches.memory","l":"MemoryRequestServer"},{"p":"org.apache.datasketches.memory","l":"Positional"},{"p":"org.apache.datasketches.memo [...]
\ No newline at end of file
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@datasketches.apache.org
For additional commands, e-mail: commits-help@datasketches.apache.org