array-get-func.html

<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">


<title>ARRAY_GET Function - SQL Notebook</title>
<link rel="stylesheet" href="sqlnotebook.css">
</head>
<body>
<header>
<table class="nav">
<tr>
<td>
<a href="index.html"><img src="art/SqlNotebookIcon.png" alt="SQL Notebook (logo)" style="width: 58px; height: 58px; float: left; margin-right: 20px;"></a>
</td>
<td>
<a href="index.html" id="title">SQL Notebook</a><br>
<nav>
<ul class="nav">
<li><a href="https://github.com/brianluft/sqlnotebook/releases">Download</a></li>
<li><a href="doc.html"><span id="header-doc-long">Documentation</span><span id="header-doc-short">Docs</span></a></li>
<li><a href="https://github.com/brianluft/sqlnotebook">GitHub</a></li>
</ul>
</nav>
</td>
</tr>
</table>
<hr style="margin-top: 15px; margin-bottom: 15px;">
</header>
<article><div id="article">
<h1><code>ARRAY_GET</code> Function</h1>
  <p>Retrieves an element at a specified index in an array.</p>
  <h2>Syntax</h2><code>ARRAY_GET(<i>array</i>, <i>element-index</i>)</code><br>
  <h2>Parameters</h2>
  <ul class="args">
    <li><i>array</i>: blob<br>
    The array from which to read an element.</li>
    <li><i>element-index</i>: integer<br>
    Zero-based index into the array.</li>
  </ul>
  <h2>Return Value</h2>The specified array element, or <code>NULL</code> if the index is outside the bounds of the
  array.<br>
  <h2>Example</h2>
  <pre>DECLARE @a = ARRAY(1, 2, 3);<br>PRINT ARRAY_GET(@a, 2);  <i>-- "3"</i><br>DECLARE @b = ARRAY_GET(@a, 10);  <i>-- @b is NULL</i><br>IF @b IS NULL PRINT 'Null!';  <i>-- Prints.</i><br></pre>
  <h2>See Also</h2>
  <ul>
    <li>
      <a moz-do-not-send="true" href="array-func.html"><tt>ARRAY</tt> Function</a><br>
    </li>
  </ul>
</div></article>
<footer><div id="footer">
<hr>
© 2016-2025 <a href="https://github.com/electroly">Brian Luft</a>
</div></footer>
</body>
</html>