blob: 6e9fda2f3fde9f5ac9f52d059bd3030dd1eb5ec7 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>HashTableDictionaryEncoder (Apache Arrow Java Root POM 17.0.0-SNAPSHOT API)</title>
<link rel="stylesheet" type="text/css" href="../../../../../stylesheet.css" title="Style">
<script type="text/javascript" src="../../../../../script.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="HashTableDictionaryEncoder (Apache Arrow Java Root POM 17.0.0-SNAPSHOT API)";
}
}
catch(err) {
}
//-->
var methods = {"i0":10};
var tabs = {65535:["t0","All Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/HashTableDictionaryEncoder.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableBasedDictionaryBuilder.html" title="class in org.apache.arrow.algorithm.dictionary"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../org/apache/arrow/algorithm/dictionary/LinearDictionaryEncoder.html" title="class in org.apache.arrow.algorithm.dictionary"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" target="_top">Frames</a></li>
<li><a href="HashTableDictionaryEncoder.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.arrow.algorithm.dictionary</div>
<h2 title="Class HashTableDictionaryEncoder" class="title">Class HashTableDictionaryEncoder&lt;E extends <a href="../../../../../org/apache/arrow/vector/BaseIntVector.html" title="interface in org.apache.arrow.vector">BaseIntVector</a>,D extends <a href="../../../../../org/apache/arrow/vector/ElementAddressableVector.html" title="interface in org.apache.arrow.vector">ElementAddressableVector</a>&gt;</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li>org.apache.arrow.algorithm.dictionary.HashTableDictionaryEncoder&lt;E,D&gt;</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt><span class="paramLabel">Type Parameters:</span></dt>
<dd><code>E</code> - encoded vector type.</dd>
<dd><code>D</code> - decoded vector type, which is also the dictionary type.</dd>
</dl>
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="../../../../../org/apache/arrow/algorithm/dictionary/DictionaryEncoder.html" title="interface in org.apache.arrow.algorithm.dictionary">DictionaryEncoder</a>&lt;E,D&gt;</dd>
</dl>
<hr>
<br>
<pre>public class <span class="typeNameLabel">HashTableDictionaryEncoder&lt;E extends <a href="../../../../../org/apache/arrow/vector/BaseIntVector.html" title="interface in org.apache.arrow.vector">BaseIntVector</a>,D extends <a href="../../../../../org/apache/arrow/vector/ElementAddressableVector.html" title="interface in org.apache.arrow.vector">ElementAddressableVector</a>&gt;</span>
extends <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>
implements <a href="../../../../../org/apache/arrow/algorithm/dictionary/DictionaryEncoder.html" title="interface in org.apache.arrow.algorithm.dictionary">DictionaryEncoder</a>&lt;E,D&gt;</pre>
<div class="block">Dictionary encoder based on hash table.</div>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html#HashTableDictionaryEncoder-D-">HashTableDictionaryEncoder</a></span>(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary)</code>
<div class="block">Constructs a dictionary encoder.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html#HashTableDictionaryEncoder-D-boolean-">HashTableDictionaryEncoder</a></span>(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary,
boolean&nbsp;encodeNull)</code>
<div class="block">Constructs a dictionary encoder.</div>
</td>
</tr>
<tr class="altColor">
<td class="colOne"><code><span class="memberNameLink"><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html#HashTableDictionaryEncoder-D-boolean-org.apache.arrow.memory.util.hash.ArrowBufHasher-">HashTableDictionaryEncoder</a></span>(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary,
boolean&nbsp;encodeNull,
<a href="../../../../../org/apache/arrow/memory/util/hash/ArrowBufHasher.html" title="interface in org.apache.arrow.memory.util.hash">ArrowBufHasher</a>&nbsp;hasher)</code>
<div class="block">Constructs a dictionary encoder.</div>
</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html#encode-D-E-">encode</a></span>(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;input,
<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">E</a>&nbsp;output)</code>
<div class="block">Encodes an input vector by a hash table.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone--" title="class or interface in java.lang">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-" title="class or interface in java.lang">equals</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--" title="class or interface in java.lang">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--" title="class or interface in java.lang">getClass</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--" title="class or interface in java.lang">hashCode</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--" title="class or interface in java.lang">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--" title="class or interface in java.lang">notifyAll</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-" title="class or interface in java.lang">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="HashTableDictionaryEncoder-org.apache.arrow.vector.ElementAddressableVector-">
<!-- -->
</a><a name="HashTableDictionaryEncoder-D-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>HashTableDictionaryEncoder</h4>
<pre>public&nbsp;HashTableDictionaryEncoder(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary)</pre>
<div class="block">Constructs a dictionary encoder.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>dictionary</code> - the dictionary.</dd>
</dl>
</li>
</ul>
<a name="HashTableDictionaryEncoder-org.apache.arrow.vector.ElementAddressableVector-boolean-">
<!-- -->
</a><a name="HashTableDictionaryEncoder-D-boolean-">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>HashTableDictionaryEncoder</h4>
<pre>public&nbsp;HashTableDictionaryEncoder(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary,
boolean&nbsp;encodeNull)</pre>
<div class="block">Constructs a dictionary encoder.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>dictionary</code> - the dictionary.</dd>
<dd><code>encodeNull</code> - a flag indicating if null should be encoded.
It determines the behaviors for processing null values in the input during encoding/decoding.
<li>
For encoding, when a null is encountered in the input,
1) If the flag is set to true, the encoder searches for the value in the dictionary,
and outputs the index in the dictionary.
2) If the flag is set to false, the encoder simply produces a null in the output.
</li>
<li>
For decoding, when a null is encountered in the input,
1) If the flag is set to true, the decoder should never expect a null in the input.
2) If set to false, the decoder simply produces a null in the output.
</li></dd>
</dl>
</li>
</ul>
<a name="HashTableDictionaryEncoder-org.apache.arrow.vector.ElementAddressableVector-boolean-org.apache.arrow.memory.util.hash.ArrowBufHasher-">
<!-- -->
</a><a name="HashTableDictionaryEncoder-D-boolean-org.apache.arrow.memory.util.hash.ArrowBufHasher-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>HashTableDictionaryEncoder</h4>
<pre>public&nbsp;HashTableDictionaryEncoder(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;dictionary,
boolean&nbsp;encodeNull,
<a href="../../../../../org/apache/arrow/memory/util/hash/ArrowBufHasher.html" title="interface in org.apache.arrow.memory.util.hash">ArrowBufHasher</a>&nbsp;hasher)</pre>
<div class="block">Constructs a dictionary encoder.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>dictionary</code> - the dictionary.</dd>
<dd><code>encodeNull</code> - a flag indicating if null should be encoded.
It determines the behaviors for processing null values in the input during encoding.
When a null is encountered in the input,
1) If the flag is set to true, the encoder searches for the value in the dictionary,
and outputs the index in the dictionary.
2) If the flag is set to false, the encoder simply produces a null in the output.</dd>
<dd><code>hasher</code> - the hasher used to calculate the hash code.</dd>
</dl>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="encode-org.apache.arrow.vector.ElementAddressableVector-org.apache.arrow.vector.BaseIntVector-">
<!-- -->
</a><a name="encode-D-E-">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>encode</h4>
<pre>public&nbsp;void&nbsp;encode(<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a>&nbsp;input,
<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">E</a>&nbsp;output)</pre>
<div class="block">Encodes an input vector by a hash table.
So the algorithm takes O(n) time, where n is the length of the input vector.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="../../../../../org/apache/arrow/algorithm/dictionary/DictionaryEncoder.html#encode-D-E-">encode</a></code>&nbsp;in interface&nbsp;<code><a href="../../../../../org/apache/arrow/algorithm/dictionary/DictionaryEncoder.html" title="interface in org.apache.arrow.algorithm.dictionary">DictionaryEncoder</a>&lt;<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">E</a> extends <a href="../../../../../org/apache/arrow/vector/BaseIntVector.html" title="interface in org.apache.arrow.vector">BaseIntVector</a>,<a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" title="type parameter in HashTableDictionaryEncoder">D</a> extends <a href="../../../../../org/apache/arrow/vector/ElementAddressableVector.html" title="interface in org.apache.arrow.vector">ElementAddressableVector</a>&gt;</code></dd>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>input</code> - the input vector.</dd>
<dd><code>output</code> - the output vector.</dd>
</dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a name="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/HashTableDictionaryEncoder.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li><a href="../../../../../org/apache/arrow/algorithm/dictionary/HashTableBasedDictionaryBuilder.html" title="class in org.apache.arrow.algorithm.dictionary"><span class="typeNameLink">Prev&nbsp;Class</span></a></li>
<li><a href="../../../../../org/apache/arrow/algorithm/dictionary/LinearDictionaryEncoder.html" title="class in org.apache.arrow.algorithm.dictionary"><span class="typeNameLink">Next&nbsp;Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../index.html?org/apache/arrow/algorithm/dictionary/HashTableDictionaryEncoder.html" target="_top">Frames</a></li>
<li><a href="HashTableDictionaryEncoder.html" target="_top">No&nbsp;Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../allclasses-noframe.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a name="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2023 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</body>
</html>