blob: b7b1d1e0dd377d23127b2a502ec8d7ef8edc7765 [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><title>R: %&lt;=&gt;%</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="R.css" />
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.3/styles/github.min.css">
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.3/highlight.min.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/8.3/languages/r.min.js"></script>
<script>hljs.initHighlightingOnLoad();</script>
</head><body>
<table width="100%" summary="page for %&amp;lt;=&amp;gt;% {SparkR}"><tr><td>%&lt;=&gt;% {SparkR}</td><td style="text-align: right;">R Documentation</td></tr></table>
<h2>%&lt;=&gt;%</h2>
<h3>Description</h3>
<p>Equality test that is safe for null values.
</p>
<h3>Usage</h3>
<pre>
x %&lt;=&gt;% value
## S4 method for signature 'Column'
x %&lt;=&gt;% value
</pre>
<h3>Arguments</h3>
<table summary="R argblock">
<tr valign="top"><td><code>x</code></td>
<td>
<p>a Column</p>
</td></tr>
<tr valign="top"><td><code>value</code></td>
<td>
<p>a value to compare</p>
</td></tr>
</table>
<h3>Details</h3>
<p>Can be used, unlike standard equality operator, to perform null-safe joins.
Equivalent to Scala <code>Column.&lt;=&gt;</code> and <code>Column.eqNullSafe</code>.
</p>
<h3>Note</h3>
<p>%&lt;=&gt;% since 2.3.0
</p>
<h3>Examples</h3>
<pre><code class="r">## Not run:
##D df1 &lt;- createDataFrame(data.frame(
##D x = c(1, NA, 3, NA), y = c(2, 6, 3, NA)
##D ))
##D
##D head(select(df1, df1$x == df1$y, df1$x %&lt;=&gt;% df1$y))
##D
##D df2 &lt;- createDataFrame(data.frame(y = c(3, NA)))
##D count(join(df1, df2, df1$y == df2$y))
##D
##D count(join(df1, df2, df1$y %&lt;=&gt;% df2$y))
## End(Not run)
</code></pre>
<hr /><div style="text-align: center;">[Package <em>SparkR</em> version 2.3.1 <a href="00Index.html">Index</a>]</div>
</body></html>