doc-exports/docs/dws/dev/dws_06_0318.html
Lu, Huayi ef0ada5a59 DWS DEV 20240716 version
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-11-02 09:07:47 +00:00

210 lines
26 KiB
HTML

<a name="EN-US_TOPIC_0000001510520921"></a><a name="EN-US_TOPIC_0000001510520921"></a>
<h1 class="topictitle1">Network Address Functions</h1>
<div id="body32001227"><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_a61bfb0aa39034b07aa12f2a57b391a1b">The <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b30817854593646">abbrev</strong>, <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b73175933693646">host</strong>, and <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b61322740893646">text</strong> functions are primarily intended to offer alternative display formats.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p9110620108">Any <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b1946921683">cidr</strong> value can be cast to <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b99462214812">inet</strong> implicitly or explicitly; therefore, the functions shown above as operating on <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b99461421881">inet</strong> also work on <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b69461322812">cidr</strong> values. An <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b679920391079">inet</strong> value can be cast to <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b1580033917716">cidr</strong>. After the conversion, any bits to the right of the subnet mask are silently zeroed to create a valid <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b1280016392078">cidr</strong> value. In addition, you can cast a text string to <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b92892569993646">inet</strong> or <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b178899675793646">cidr</strong> using normal casting syntax. For example, <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b1228174511716">inet(expression)</strong> or <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b1328245979">colname::cidr</strong>.</p>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section117714536347"><h4 class="sectiontitle">abbrev(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1476517533342">Description: Abbreviated display format as text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p97658538346">Return type: text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1676516539343">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen1276625312342"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">abbrev</span><span class="p">(</span><span class="n">inet</span><span class="w"> </span><span class="s1">'10.1.0.0/16'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">10</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">0</span><span class="p">.</span><span class="mi">0</span><span class="o">/</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section57151574351"><h4 class="sectiontitle">abbrev(cidr)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p2070913743514">Description: Abbreviated display format as text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p167091977350">Return type: text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p07097733519">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen571018718351"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">abbrev</span><span class="p">(</span><span class="n">cidr</span><span class="w"> </span><span class="s1">'10.1.0.0/16'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">10</span><span class="p">.</span><span class="mi">1</span><span class="o">/</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section18116111353513"><h4 class="sectiontitle">broadcast(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1111115131351">Description: Broadcast address for network</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p101111113143519">Return type: inet</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1211181353517">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen611118132351"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">broadcast</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">------------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">255</span><span class="o">/</span><span class="mi">24</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section1112219311737"><h4 class="sectiontitle">family(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p711512311936">Description: Extracts family of address; <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b164525861093646">4</strong> for IPv4, <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b194305696693646">6</strong> for IPv6</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1111533112313">Return type: int</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p171150311038">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen161168312039"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">family</span><span class="p">(</span><span class="s1">'::1'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">6</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section45127341235"><h4 class="sectiontitle">host(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p85091234237">Description: Extracts IP address as text.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p9509133418312">Return type: text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p55096341033">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen55092343318"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="k">host</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">-------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">5</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section1360618378311"><h4 class="sectiontitle">hostmask(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p660112373320">Description: Constructs host mask for network.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p146011137230">Return type: inet</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p66011237335">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen360215371337"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">hostmask</span><span class="p">(</span><span class="s1">'192.168.23.20/30'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------</span>
<span class="w"> </span><span class="mi">0</span><span class="p">.</span><span class="mi">0</span><span class="p">.</span><span class="mi">0</span><span class="p">.</span><span class="mi">3</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section452217545915"><h4 class="sectiontitle">masklen(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p9519954096">Description: Extracts subnet mask length.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p165207541292">Return type: int</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p125201954296">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen155207547913"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">masklen</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">--------</span>
<span class="w"> </span><span class="mi">24</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section6616145715919"><h4 class="sectiontitle">netmask(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p136143570912">Description: Constructs a subnet mask for the network.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p8614165713917">Return type: inet</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p14614165720918">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen16144571799"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">netmask</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">---------------</span>
<span class="w"> </span><span class="mi">255</span><span class="p">.</span><span class="mi">255</span><span class="p">.</span><span class="mi">255</span><span class="p">.</span><span class="mi">0</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section1610081121016"><h4 class="sectiontitle">network(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p296151161017">Description: Extracts network part of address.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1596121121017">Return type: cidr</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p129610120107">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen09715111010"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">network</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">0</span><span class="o">/</span><span class="mi">24</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section235541012"><h4 class="sectiontitle">set_masklen(inet, int)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p12253101">Description: Sets subnet mask length for <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b153622768693646">inet</strong> value.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p182756108">Return type: inet</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p11255181020">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen321958108"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">set_masklen</span><span class="p">(</span><span class="s1">'192.168.1.5/24'</span><span class="p">,</span><span class="w"> </span><span class="mi">16</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">5</span><span class="o">/</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section13828294109"><h4 class="sectiontitle">set_masklen(cidr, int)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p48261290103">Description: Sets subnet mask length for <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b46613646193646">cidr</strong> value.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1882717916105">Return type: cidr</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p1482714916103">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen482712971016"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">set_masklen</span><span class="p">(</span><span class="s1">'192.168.1.0/24'</span><span class="p">::</span><span class="n">cidr</span><span class="p">,</span><span class="w"> </span><span class="mi">16</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">0</span><span class="p">.</span><span class="mi">0</span><span class="o">/</span><span class="mi">16</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_section19876512151018"><h4 class="sectiontitle">text(inet)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p78751312141017">Description: Extracts IP address and subnet mask length as text.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p4875151218109">Return type: text</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_p0875191271019">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_screen118761812131014"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="nb">text</span><span class="p">(</span><span class="n">inet</span><span class="w"> </span><span class="s1">'192.168.1.5'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">----------------</span>
<span class="w"> </span><span class="mi">192</span><span class="p">.</span><span class="mi">168</span><span class="p">.</span><span class="mi">1</span><span class="p">.</span><span class="mi">5</span><span class="o">/</span><span class="mi">32</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_s20277f9f2cc141fd879ec3f21abc485e"><h4 class="sectiontitle">trunc(macaddr)</h4><p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_af89cc7e2065c481596256d724a3ab055">The function <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b8829423093646">trunc(macaddr)</strong> returns a MAC address with the last 3 bytes set to zero.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_ac651b239bf764c2090bd78b1fc2ac569">Description: Sets last 3 bytes to zero.</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_adc52a8c2d3b8469ea96b921f868c82a2">Return type: macaddr</p>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_ae1334b14043d4ead80e9fb47c6d0eee0">Example:</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_sb27ba3656b434af88ed6c67d26409e29"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span>
<span class="normal">4</span>
<span class="normal">5</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">SELECT</span><span class="w"> </span><span class="n">trunc</span><span class="p">(</span><span class="n">macaddr</span><span class="w"> </span><span class="s1">'12:34:56:78:90:ab'</span><span class="p">)</span><span class="w"> </span><span class="k">AS</span><span class="w"> </span><span class="k">RESULT</span><span class="p">;</span>
<span class="w"> </span><span class="k">result</span><span class="w"> </span>
<span class="c1">-------------------</span>
<span class="w"> </span><span class="mi">12</span><span class="p">:</span><span class="mi">34</span><span class="p">:</span><span class="mi">56</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span><span class="p">:</span><span class="mi">00</span>
<span class="p">(</span><span class="mi">1</span><span class="w"> </span><span class="k">row</span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
<p id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_a8182cdebc465488a940af73978ce4a6b">The <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b210032194893646">macaddr</strong> type also supports the standard relational operators (such as <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b83752047493646">&gt;</strong> and <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b112531093093646">&lt;=</strong>) for lexicographical ordering, and the bitwise arithmetic operators (<strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b128607573893646">~</strong>, <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b85751166093646">&amp;</strong> and <strong id="EN-US_TOPIC_0000001510520921__en-us_topic_0000001444487972_b159333312993646">|</strong>) for NOT, AND and OR.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0038.html">Network Address Functions and Operators</a></div>
</div>
</div>