This is an automated email from the ASF dual-hosted git repository.
github-actions[bot] pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/arrow-dotnet.git
The following commit(s) were added to refs/heads/asf-site by this push:
new e007cf6 Update docs for c0e20b608ccd2ed92d0867d6205ec8bf1c708ac3
e007cf6 is described below
commit e007cf62729c64977f2061741329a8ec60beb42c
Author: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
AuthorDate: Sun Apr 26 15:41:44 2026 +0000
Update docs for c0e20b608ccd2ed92d0867d6205ec8bf1c708ac3
---
main/api/Apache.Arrow.BinaryArray.Builder.html | 6 ++
.../Apache.Arrow.BinaryArray.BuilderBase-2.html | 102 ++++++++++++++++++---
main/api/Apache.Arrow.BinaryArray.html | 20 ++--
main/api/Apache.Arrow.StringArray.Builder.html | 8 +-
main/api/Apache.Arrow.StringArray.html | 12 +--
main/index.json | 6 +-
main/xrefmap.yml | 36 ++++++++
7 files changed, 155 insertions(+), 35 deletions(-)
diff --git a/main/api/Apache.Arrow.BinaryArray.Builder.html
b/main/api/Apache.Arrow.BinaryArray.Builder.html
index 2de8f00..3515dc9 100644
--- a/main/api/Apache.Arrow.BinaryArray.Builder.html
+++ b/main/api/Apache.Arrow.BinaryArray.Builder.html
@@ -154,6 +154,12 @@ Class BinaryArray.Builder <a class="header-action
link-secondary" title="View s
<div>
<a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Build_Apache_Arrow_ArrayData_">BinaryArray.BuilderBase<BinaryArray,
BinaryArray.Builder>.Build(ArrayData)</a>
</div>
+ <div>
+ <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_">BinaryArray.BuilderBase<BinaryArray,
BinaryArray.Builder>.GetValueBufferSpan(int)</a>
+ </div>
+ <div>
+ <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_System_Int32_">BinaryArray.BuilderBase<BinaryArray,
BinaryArray.Builder>.AdvanceValueBuffer(int)</a>
+ </div>
<div>
<a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Length">BinaryArray.BuilderBase<BinaryArray,
BinaryArray.Builder>.Length</a>
</div>
diff --git a/main/api/Apache.Arrow.BinaryArray.BuilderBase-2.html
b/main/api/Apache.Arrow.BinaryArray.BuilderBase-2.html
index 9c32128..2a9510c 100644
--- a/main/api/Apache.Arrow.BinaryArray.BuilderBase-2.html
+++ b/main/api/Apache.Arrow.BinaryArray.BuilderBase-2.html
@@ -179,7 +179,7 @@ Class BinaryArray.BuilderBase<TArray, TBuilder> <a
class="header-action l
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2__ctor_Apache_Arrow_Types_IArrowType_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.#ctor(Apache.Arrow.Types.IArrowType)">
BuilderBase(IArrowType)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L64"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L65"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -276,7 +276,7 @@ Class BinaryArray.BuilderBase<TArray, TBuilder> <a
class="header-action l
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_Length"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Length">
Length
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L88"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L127"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Gets the length of the array built
so far.</p>
@@ -463,11 +463,44 @@ Class BinaryArray.BuilderBase<TArray, TBuilder> <a
class="header-action l
</h2>
+ <a id="Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer*"></a>
+
+ <h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer(System.Int32)">
+ AdvanceValueBuffer(int)
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L108"><i
class="bi bi-code-slash"></i></a>
+ </h3>
+
+ <div class="markdown level1 summary"><p>Commits bytes previously written
into the span returned by <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_">GetValueBufferSpan(int)</a>.</p>
+</div>
+ <div class="markdown level1 conceptual"></div>
+
+ <div class="codewrapper">
+ <pre><code class="lang-csharp hljs">protected void AdvanceValueBuffer(int
count)</code></pre>
+ </div>
+
+ <h4 class="section">Parameters</h4>
+ <dl class="parameters">
+ <dt><code>count</code> <a class="xref"
href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
+ <dd><p>The number of bytes written to the span returned by the latest <a
class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_">GetValueBufferSpan(int)</a>
call.</p>
+</dd>
+ </dl>
+
+
+
+
+
+
+
+
+
+
+
+
<a id="Apache_Arrow_BinaryArray_BuilderBase_2_Append_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Append*"></a>
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_Append_System_Byte_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Append(System.Byte)">
Append(byte)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L131"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L170"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Appends a value, consisting of a
single byte, to the array.</p>
@@ -506,7 +539,7 @@ Class BinaryArray.BuilderBase<TArray, TBuilder> <a
class="header-action l
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Append_System_Collections_Generic_IEnumerable_System_Byte__"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Append(System.Collections.Generic.IEnumerable{System.Byte})">
Append(IEnumerable<byte>)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L167"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L206"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Append a value, consisting of an
enumerable collection of bytes, to the array.</p>
@@ -549,7 +582,7 @@ values are to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.B
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Append_System_ReadOnlySpan_System_Byte__"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Append(System.ReadOnlySpan{System.Byte})">
Append(ReadOnlySpan<byte>)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L149"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L188"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Append a value, consisting of a span
of bytes, to the array.</p>
@@ -592,7 +625,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_AppendNull"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.AppendNull">
AppendNull()
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L117"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L156"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Append a single null value to the
array.</p>
@@ -625,7 +658,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_AppendRange_System_Collections_Generic_IEnumerable_System_Byte____"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.AppendRange(System.Collections.Generic.IEnumerable{System.Byte[]})">
AppendRange(IEnumerable<byte[]>)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L214"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L253"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Append an enumerable collection of
values to the array.</p>
@@ -664,7 +697,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_AppendRange_System_Collections_Generic_IEnumerable_System_Byte__"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.AppendRange(System.Collections.Generic.IEnumerable{System.Byte})">
AppendRange(IEnumerable<byte>)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L194"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L233"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Append an enumerable collection of
single-byte values to the array.</p>
@@ -707,7 +740,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Build_Apache_Arrow_ArrayData_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Build(Apache.Arrow.ArrayData)">
Build(ArrayData)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L83"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L84"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -743,7 +776,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Build_Apache_Arrow_Memory_MemoryAllocator_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Build(Apache.Arrow.Memory.MemoryAllocator)">
Build(MemoryAllocator)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L95"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L134"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Build an Arrow array from the
appended contents so far.</p>
@@ -782,7 +815,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_Clear"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Clear">
Clear()
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L270"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L309"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Clear all contents appended so
far.</p>
@@ -811,11 +844,50 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
+ <a id="Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan*"></a>
+
+ <h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan(System.Int32)">
+ GetValueBufferSpan(int)
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L91"><i
class="bi bi-code-slash"></i></a>
+ </h3>
+
+ <div class="markdown level1 summary"><p>Returns writable value-buffer space
without changing the committed buffer length.</p>
+</div>
+ <div class="markdown level1 conceptual"></div>
+
+ <div class="codewrapper">
+ <pre><code class="lang-csharp hljs">protected Span<byte>
GetValueBufferSpan(int sizeHint)</code></pre>
+ </div>
+
+ <h4 class="section">Parameters</h4>
+ <dl class="parameters">
+ <dt><code>sizeHint</code> <a class="xref"
href="https://learn.microsoft.com/dotnet/api/system.int32">int</a></dt>
+ <dd><p>The minimum number of writable bytes required.</p>
+</dd>
+ </dl>
+
+ <h4 class="section">Returns</h4>
+ <dl class="parameters">
+ <dt><a class="xref"
href="https://learn.microsoft.com/dotnet/api/system.span-1">Span</a><<a
class="xref"
href="https://learn.microsoft.com/dotnet/api/system.byte">byte</a>></dt>
+ <dd><p>A span starting at the first uncommitted byte in the value
buffer.</p>
+</dd>
+ </dl>
+
+
+
+
+
+
+
+
+
+
+
<a id="Apache_Arrow_BinaryArray_BuilderBase_2_Reserve_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Reserve*"></a>
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_Reserve_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Reserve(System.Int32)">
Reserve(int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L236"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L275"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -851,7 +923,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3 id="Apache_Arrow_BinaryArray_BuilderBase_2_Resize_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Resize(System.Int32)">
Resize(int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L245"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L284"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -887,7 +959,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Set_System_Int32_System_Byte_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Set(System.Int32,System.Byte)">
Set(int, byte)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L260"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L299"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -925,7 +997,7 @@ to be added, use the <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-
<h3
id="Apache_Arrow_BinaryArray_BuilderBase_2_Swap_System_Int32_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.BuilderBase`2.Swap(System.Int32,System.Int32)">
Swap(int, int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L254"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L293"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
diff --git a/main/api/Apache.Arrow.BinaryArray.html
b/main/api/Apache.Arrow.BinaryArray.html
index 9291d31..11bb38c 100644
--- a/main/api/Apache.Arrow.BinaryArray.html
+++ b/main/api/Apache.Arrow.BinaryArray.html
@@ -279,7 +279,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3
id="Apache_Arrow_BinaryArray__ctor_Apache_Arrow_Types_IArrowType_System_Int32_Apache_Arrow_ArrowBuffer_Apache_Arrow_ArrowBuffer_Apache_Arrow_ArrowBuffer_System_Int32_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.#ctor(Apache.Arrow.Types.IArrowType,System.Int32,Apache.Arrow.ArrowBuffer,Apache.Arrow.ArrowBuffer,Apache.Arrow.ArrowBuffer,System.Int32,System.Int32)">
BinaryArray(IArrowType, int, ArrowBuffer, ArrowBuffer, ArrowBuffer, int, int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L283"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L322"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -326,7 +326,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_ValueBuffer"
data-uid="Apache.Arrow.BinaryArray.ValueBuffer">
ValueBuffer
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L296"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L335"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -357,7 +357,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_ValueOffsets"
data-uid="Apache.Arrow.BinaryArray.ValueOffsets">
ValueOffsets
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L298"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L337"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -388,7 +388,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_ValueOffsetsBuffer"
data-uid="Apache.Arrow.BinaryArray.ValueOffsetsBuffer">
ValueOffsetsBuffer
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L294"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L333"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -419,7 +419,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_Values"
data-uid="Apache.Arrow.BinaryArray.Values">
Values
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L300"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L339"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -454,7 +454,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_Accept_Apache_Arrow_IArrowArrayVisitor_"
data-uid="Apache.Arrow.BinaryArray.Accept(Apache.Arrow.IArrowArrayVisitor)">
Accept(IArrowArrayVisitor)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L292"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L331"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -485,7 +485,7 @@ Class BinaryArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_BinaryArray_GetBytes_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.GetBytes(System.Int32)">
GetBytes(int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L342"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L381"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Get the collection of bytes, as a
read-only span, at a given index in the array.</p>
@@ -536,7 +536,7 @@ to reliably determine null values.</p>
<h3 id="Apache_Arrow_BinaryArray_GetBytes_System_Int32_System_Boolean__"
data-uid="Apache.Arrow.BinaryArray.GetBytes(System.Int32,System.Boolean@)">
GetBytes(int, out bool)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L352"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L391"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Get the collection of bytes, as a
read-only span, at a given index in the array.</p>
@@ -584,7 +584,7 @@ to reliably determine null values.</p>
<h3 id="Apache_Arrow_BinaryArray_GetValueLength_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.GetValueLength(System.Int32)">
GetValueLength(int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L313"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L352"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -620,7 +620,7 @@ to reliably determine null values.</p>
<h3 id="Apache_Arrow_BinaryArray_GetValueOffset_System_Int32_"
data-uid="Apache.Arrow.BinaryArray.GetValueOffset(System.Int32)">
GetValueOffset(int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L302"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/BinaryArray.cs/#L341"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
diff --git a/main/api/Apache.Arrow.StringArray.Builder.html
b/main/api/Apache.Arrow.StringArray.Builder.html
index 1e8d8f3..c5df1a6 100644
--- a/main/api/Apache.Arrow.StringArray.Builder.html
+++ b/main/api/Apache.Arrow.StringArray.Builder.html
@@ -154,6 +154,12 @@ Class StringArray.Builder <a class="header-action
link-secondary" title="View s
<div>
<a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Build_Apache_Arrow_ArrayData_">BinaryArray.BuilderBase<StringArray,
StringArray.Builder>.Build(ArrayData)</a>
</div>
+ <div>
+ <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_">BinaryArray.BuilderBase<StringArray,
StringArray.Builder>.GetValueBufferSpan(int)</a>
+ </div>
+ <div>
+ <a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_System_Int32_">BinaryArray.BuilderBase<StringArray,
StringArray.Builder>.AdvanceValueBuffer(int)</a>
+ </div>
<div>
<a class="xref"
href="Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Length">BinaryArray.BuilderBase<StringArray,
StringArray.Builder>.Length</a>
</div>
@@ -297,7 +303,7 @@ Class StringArray.Builder <a class="header-action
link-secondary" title="View s
<h3
id="Apache_Arrow_StringArray_Builder_AppendRange_System_Collections_Generic_IEnumerable_System_String__System_Text_Encoding_"
data-uid="Apache.Arrow.StringArray.Builder.AppendRange(System.Collections.Generic.IEnumerable{System.String},System.Text.Encoding)">
AppendRange(IEnumerable<string>, Encoding)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L51"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L69"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
diff --git a/main/api/Apache.Arrow.StringArray.html
b/main/api/Apache.Arrow.StringArray.html
index 08967b7..09868bc 100644
--- a/main/api/Apache.Arrow.StringArray.html
+++ b/main/api/Apache.Arrow.StringArray.html
@@ -238,7 +238,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_StringArray__ctor_Apache_Arrow_ArrayData_"
data-uid="Apache.Arrow.StringArray.#ctor(Apache.Arrow.ArrayData)">
StringArray(ArrayData)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L62"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L98"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -269,7 +269,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3
id="Apache_Arrow_StringArray__ctor_System_Int32_Apache_Arrow_ArrowBuffer_Apache_Arrow_ArrowBuffer_Apache_Arrow_ArrowBuffer_System_Int32_System_Int32_"
data-uid="Apache.Arrow.StringArray.#ctor(System.Int32,Apache.Arrow.ArrowBuffer,Apache.Arrow.ArrowBuffer,Apache.Arrow.ArrowBuffer,System.Int32,System.Int32)">
StringArray(int, ArrowBuffer, ArrowBuffer, ArrowBuffer, int, int)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L65"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L101"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -348,7 +348,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_StringArray_Accept_Apache_Arrow_IArrowArrayVisitor_"
data-uid="Apache.Arrow.StringArray.Accept(Apache.Arrow.IArrowArrayVisitor)">
Accept(IArrowArrayVisitor)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L74"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L110"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"></div>
@@ -379,7 +379,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3
id="Apache_Arrow_StringArray_GetString_System_Int32_System_Text_Encoding_"
data-uid="Apache.Arrow.StringArray.GetString(System.Int32,System.Text.Encoding)">
GetString(int, Encoding)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L82"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L118"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Get the string value at the given
index</p>
@@ -421,7 +421,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_StringArray_IsMaterialized_System_Text_Encoding_"
data-uid="Apache.Arrow.StringArray.IsMaterialized(System.Text.Encoding)">
IsMaterialized(Encoding)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L143"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L179"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Check if the array has been
materialized for the given encoding</p>
@@ -460,7 +460,7 @@ Class StringArray <a class="header-action link-secondary"
title="View source" h
<h3 id="Apache_Arrow_StringArray_Materialize_System_Text_Encoding_"
data-uid="Apache.Arrow.StringArray.Materialize(System.Text.Encoding)">
Materialize(Encoding)
- <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L115"><i
class="bi bi-code-slash"></i></a>
+ <a class="header-action link-secondary" title="View source"
href="https://github.com/apache/arrow-dotnet/blob/main/src/Apache.Arrow/Arrays/StringArray.cs/#L151"><i
class="bi bi-code-slash"></i></a>
</h3>
<div class="markdown level1 summary"><p>Materialize the array for the given
encoding to accelerate the string access</p>
diff --git a/main/index.json b/main/index.json
index c9f1405..b61e1e4 100644
--- a/main/index.json
+++ b/main/index.json
@@ -77,12 +77,12 @@
"api/Apache.Arrow.BinaryArray.Builder.html": {
"href": "api/Apache.Arrow.BinaryArray.Builder.html",
"title": "Class BinaryArray.Builder | Apache Arrow .NET",
- "summary": "Class BinaryArray.Builder Namespace Apache.Arrow Assembly
Apache.Arrow.dll public class BinaryArray.Builder :
BinaryArray.BuilderBase<BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<byte, BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<BinaryArray>, IArrowArrayBuilder Inheritance object
BinaryArray.BuilderBase<BinaryArray, BinaryArray.Builder> BinaryArray.Builder
Implements IArrowArrayBuilder<byte, BinaryAr [...]
+ "summary": "Class BinaryArray.Builder Namespace Apache.Arrow Assembly
Apache.Arrow.dll public class BinaryArray.Builder :
BinaryArray.BuilderBase<BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<byte, BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<BinaryArray, BinaryArray.Builder>,
IArrowArrayBuilder<BinaryArray>, IArrowArrayBuilder Inheritance object
BinaryArray.BuilderBase<BinaryArray, BinaryArray.Builder> BinaryArray.Builder
Implements IArrowArrayBuilder<byte, BinaryAr [...]
},
"api/Apache.Arrow.BinaryArray.BuilderBase-2.html": {
"href": "api/Apache.Arrow.BinaryArray.BuilderBase-2.html",
"title": "Class BinaryArray.BuilderBase<TArray, TBuilder> | Apache Arrow
.NET",
- "summary": "Class BinaryArray.BuilderBase<TArray, TBuilder> Namespace
Apache.Arrow Assembly Apache.Arrow.dll public abstract class
BinaryArray.BuilderBase<TArray, TBuilder> : IArrowArrayBuilder<byte, TArray,
TBuilder>, IArrowArrayBuilder<TArray, TBuilder>, IArrowArrayBuilder<TArray>,
IArrowArrayBuilder where TArray : IArrowArray where TBuilder : class,
IArrowArrayBuilder<byte, TArray, TBuilder> Type Parameters TArray TBuilder
Inheritance object BinaryArray.BuilderBase<TArray, TBuilde [...]
+ "summary": "Class BinaryArray.BuilderBase<TArray, TBuilder> Namespace
Apache.Arrow Assembly Apache.Arrow.dll public abstract class
BinaryArray.BuilderBase<TArray, TBuilder> : IArrowArrayBuilder<byte, TArray,
TBuilder>, IArrowArrayBuilder<TArray, TBuilder>, IArrowArrayBuilder<TArray>,
IArrowArrayBuilder where TArray : IArrowArray where TBuilder : class,
IArrowArrayBuilder<byte, TArray, TBuilder> Type Parameters TArray TBuilder
Inheritance object BinaryArray.BuilderBase<TArray, TBuilde [...]
},
"api/Apache.Arrow.BinaryArray.html": {
"href": "api/Apache.Arrow.BinaryArray.html",
@@ -1167,7 +1167,7 @@
"api/Apache.Arrow.StringArray.Builder.html": {
"href": "api/Apache.Arrow.StringArray.Builder.html",
"title": "Class StringArray.Builder | Apache Arrow .NET",
- "summary": "Class StringArray.Builder Namespace Apache.Arrow Assembly
Apache.Arrow.dll public class StringArray.Builder :
BinaryArray.BuilderBase<StringArray, StringArray.Builder>,
IArrowArrayBuilder<byte, StringArray, StringArray.Builder>,
IArrowArrayBuilder<StringArray, StringArray.Builder>,
IArrowArrayBuilder<StringArray>, IArrowArrayBuilder Inheritance object
BinaryArray.BuilderBase<StringArray, StringArray.Builder> StringArray.Builder
Implements IArrowArrayBuilder<byte, StringAr [...]
+ "summary": "Class StringArray.Builder Namespace Apache.Arrow Assembly
Apache.Arrow.dll public class StringArray.Builder :
BinaryArray.BuilderBase<StringArray, StringArray.Builder>,
IArrowArrayBuilder<byte, StringArray, StringArray.Builder>,
IArrowArrayBuilder<StringArray, StringArray.Builder>,
IArrowArrayBuilder<StringArray>, IArrowArrayBuilder Inheritance object
BinaryArray.BuilderBase<StringArray, StringArray.Builder> StringArray.Builder
Implements IArrowArrayBuilder<byte, StringAr [...]
},
"api/Apache.Arrow.StringArray.html": {
"href": "api/Apache.Arrow.StringArray.html",
diff --git a/main/xrefmap.yml b/main/xrefmap.yml
index a0cb8a8..18aa070 100644
--- a/main/xrefmap.yml
+++ b/main/xrefmap.yml
@@ -1848,6 +1848,24 @@ references:
fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray, TBuilder).New
nameWithType: BinaryArray.BuilderBase<TArray, TBuilder>.BuilderBase
nameWithType.vb: BinaryArray.BuilderBase(Of TArray, TBuilder).New
+- uid: Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer(System.Int32)
+ name: AdvanceValueBuffer(int)
+ href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_System_Int32_
+ commentId:
M:Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer(System.Int32)
+ name.vb: AdvanceValueBuffer(Integer)
+ fullName: Apache.Arrow.BinaryArray.BuilderBase<TArray,
TBuilder>.AdvanceValueBuffer(int)
+ fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray,
TBuilder).AdvanceValueBuffer(Integer)
+ nameWithType: BinaryArray.BuilderBase<TArray,
TBuilder>.AdvanceValueBuffer(int)
+ nameWithType.vb: BinaryArray.BuilderBase(Of TArray,
TBuilder).AdvanceValueBuffer(Integer)
+- uid: Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer*
+ name: AdvanceValueBuffer
+ href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_AdvanceValueBuffer_
+ commentId: Overload:Apache.Arrow.BinaryArray.BuilderBase`2.AdvanceValueBuffer
+ isSpec: "True"
+ fullName: Apache.Arrow.BinaryArray.BuilderBase<TArray,
TBuilder>.AdvanceValueBuffer
+ fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray,
TBuilder).AdvanceValueBuffer
+ nameWithType: BinaryArray.BuilderBase<TArray, TBuilder>.AdvanceValueBuffer
+ nameWithType.vb: BinaryArray.BuilderBase(Of TArray,
TBuilder).AdvanceValueBuffer
- uid: Apache.Arrow.BinaryArray.BuilderBase`2.Append(System.Byte)
name: Append(byte)
href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Append_System_Byte_
@@ -1987,6 +2005,24 @@ references:
fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray,
TBuilder).DataType
nameWithType: BinaryArray.BuilderBase<TArray, TBuilder>.DataType
nameWithType.vb: BinaryArray.BuilderBase(Of TArray, TBuilder).DataType
+- uid: Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan(System.Int32)
+ name: GetValueBufferSpan(int)
+ href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_System_Int32_
+ commentId:
M:Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan(System.Int32)
+ name.vb: GetValueBufferSpan(Integer)
+ fullName: Apache.Arrow.BinaryArray.BuilderBase<TArray,
TBuilder>.GetValueBufferSpan(int)
+ fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray,
TBuilder).GetValueBufferSpan(Integer)
+ nameWithType: BinaryArray.BuilderBase<TArray,
TBuilder>.GetValueBufferSpan(int)
+ nameWithType.vb: BinaryArray.BuilderBase(Of TArray,
TBuilder).GetValueBufferSpan(Integer)
+- uid: Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan*
+ name: GetValueBufferSpan
+ href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_GetValueBufferSpan_
+ commentId: Overload:Apache.Arrow.BinaryArray.BuilderBase`2.GetValueBufferSpan
+ isSpec: "True"
+ fullName: Apache.Arrow.BinaryArray.BuilderBase<TArray,
TBuilder>.GetValueBufferSpan
+ fullName.vb: Apache.Arrow.BinaryArray.BuilderBase(Of TArray,
TBuilder).GetValueBufferSpan
+ nameWithType: BinaryArray.BuilderBase<TArray, TBuilder>.GetValueBufferSpan
+ nameWithType.vb: BinaryArray.BuilderBase(Of TArray,
TBuilder).GetValueBufferSpan
- uid: Apache.Arrow.BinaryArray.BuilderBase`2.Instance
name: Instance
href:
api/Apache.Arrow.BinaryArray.BuilderBase-2.html#Apache_Arrow_BinaryArray_BuilderBase_2_Instance