<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.11"/>
<title>ZVBI Library: BCD arithmetic for Teletext page numbers</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">ZVBI Library
 <span id="projectnumber">0.2.35</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.11 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li class="current"><a href="modules.html"><span>Modules</span></a></li>
<li><a href="annotated.html"><span>Data Structures</span></a></li>
<li><a href="examples.html"><span>Examples</span></a></li>
</ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#define-members">Macros</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">BCD arithmetic for Teletext page numbers<div class="ingroups"><a class="el" href="group__HiDec.html">High Level Decoding</a></div></div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="define-members"></a>
Macros</h2></td></tr>
<tr class="memitem:gaa19b8103cc48b617476b4a690b2855bb"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#gaa19b8103cc48b617476b4a690b2855bb">vbi_bin2bcd</a>(n)   <a class="el" href="group__BCD.html#ga92ef99808a256e491dc4c4e799c5d1c7">vbi_dec2bcd</a>(n)</td></tr>
<tr class="separator:gaa19b8103cc48b617476b4a690b2855bb"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga5944d69bf5506c7b3e54f5fad5df1845"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#ga5944d69bf5506c7b3e54f5fad5df1845">vbi_bcd2bin</a>(n)   <a class="el" href="group__BCD.html#gaaab48eea04af25bcfb69dd27a9a6be28">vbi_bcd2dec</a>(n)</td></tr>
<tr class="separator:ga5944d69bf5506c7b3e54f5fad5df1845"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:ga92ef99808a256e491dc4c4e799c5d1c7"><td class="memItemLeft" align="right" valign="top">_vbi_inline unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#ga92ef99808a256e491dc4c4e799c5d1c7">vbi_dec2bcd</a> (unsigned int dec)</td></tr>
<tr class="separator:ga92ef99808a256e491dc4c4e799c5d1c7"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:gaaab48eea04af25bcfb69dd27a9a6be28"><td class="memItemLeft" align="right" valign="top">_vbi_inline unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#gaaab48eea04af25bcfb69dd27a9a6be28">vbi_bcd2dec</a> (unsigned int bcd)</td></tr>
<tr class="separator:gaaab48eea04af25bcfb69dd27a9a6be28"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga3a82b6744642f1d5be836914ce01a2e1"><td class="memItemLeft" align="right" valign="top">_vbi_inline unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#ga3a82b6744642f1d5be836914ce01a2e1">vbi_add_bcd</a> (unsigned int a, unsigned int b)</td></tr>
<tr class="separator:ga3a82b6744642f1d5be836914ce01a2e1"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga557e0e23dd907e1aa77e8b2112b43d5c"><td class="memItemLeft" align="right" valign="top">_vbi_inline vbi_bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#ga557e0e23dd907e1aa77e8b2112b43d5c">vbi_is_bcd</a> (unsigned int bcd)</td></tr>
<tr class="separator:ga557e0e23dd907e1aa77e8b2112b43d5c"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:ga23963822415da5f4516a5a61113106d1"><td class="memItemLeft" align="right" valign="top">_vbi_inline vbi_bool </td><td class="memItemRight" valign="bottom"><a class="el" href="group__BCD.html#ga23963822415da5f4516a5a61113106d1">vbi_bcd_digits_greater</a> (unsigned int bcd, unsigned int maximum)</td></tr>
<tr class="separator:ga23963822415da5f4516a5a61113106d1"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<p>Teletext page numbers are expressed as packed binary coded decimal numbers in range 0x100 to 0x8FF. The bcd format encodes one decimal digit in every hex nibble (four bits) of the number. Page numbers containing digits 0xA to 0xF are reserved for various system purposes and not intended for display. </p>
<h2 class="groupheader">Macro Definition Documentation</h2>
<a class="anchor" id="gaa19b8103cc48b617476b4a690b2855bb"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define vbi_bin2bcd</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">n</td><td>)</td>
<td>   <a class="el" href="group__BCD.html#ga92ef99808a256e491dc4c4e799c5d1c7">vbi_dec2bcd</a>(n)</td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section since"><dt>Since</dt><dd>0.2.28 </dd></dl>
</div>
</div>
<a class="anchor" id="ga5944d69bf5506c7b3e54f5fad5df1845"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define vbi_bcd2bin</td>
<td>(</td>
<td class="paramtype"> </td>
<td class="paramname">n</td><td>)</td>
<td>   <a class="el" href="group__BCD.html#gaaab48eea04af25bcfb69dd27a9a6be28">vbi_bcd2dec</a>(n)</td>
</tr>
</table>
</div><div class="memdoc">
<dl class="section since"><dt>Since</dt><dd>0.2.28 </dd></dl>
</div>
</div>
<h2 class="groupheader">Function Documentation</h2>
<a class="anchor" id="ga92ef99808a256e491dc4c4e799c5d1c7"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_vbi_inline unsigned int vbi_dec2bcd </td>
<td>(</td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>dec</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">dec</td><td>Decimal number.</td></tr>
</table>
</dd>
</dl>
<p>Converts a two's complement binary between 0 ... 999 to a packed bcd number in range 0x000 ... 0x999. Extra digits in the input will be discarded.</p>
<dl class="section return"><dt>Returns</dt><dd>BCD number. </dd></dl>
</div>
</div>
<a class="anchor" id="gaaab48eea04af25bcfb69dd27a9a6be28"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_vbi_inline unsigned int vbi_bcd2dec </td>
<td>(</td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>bcd</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bcd</td><td>BCD number.</td></tr>
</table>
</dd>
</dl>
<p>Converts a packed bcd number between 0x000 ... 0xFFF to a two's complement binary in range 0 ... 999. Extra digits in the input will be discarded.</p>
<dl class="section return"><dt>Returns</dt><dd>Decimal number. The result is undefined when the bcd number contains hex digits 0xA ... 0xF. </dd></dl>
</div>
</div>
<a class="anchor" id="ga3a82b6744642f1d5be836914ce01a2e1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_vbi_inline unsigned int vbi_add_bcd </td>
<td>(</td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>a</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>b</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">a</td><td>BCD number. </td></tr>
<tr><td class="paramname">b</td><td>BCD number.</td></tr>
</table>
</dd>
</dl>
<p>Adds two packed bcd numbers, returning a packed bcd sum. Arguments and result are in range 0xF000 0000 ... 0x0999 9999, that is -10**7 ... +10**7 - 1 in decimal notation. To subtract you can add the 10's complement, e. g. -1 = 0xF999 9999.</p>
<dl class="section return"><dt>Returns</dt><dd>Packed bcd number. The result is undefined when any of the arguments contain hex digits 0xA ... 0xF. </dd></dl>
</div>
</div>
<a class="anchor" id="ga557e0e23dd907e1aa77e8b2112b43d5c"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_vbi_inline vbi_bool vbi_is_bcd </td>
<td>(</td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>bcd</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bcd</td><td>BCD number.</td></tr>
</table>
</dd>
</dl>
<p>Tests if <em>bcd</em> forms a valid BCD number. The argument must be in range 0x0000 0000 ... 0x0999 9999.</p>
<dl class="section return"><dt>Returns</dt><dd><code>FALSE</code> if <em>bcd</em> contains hex digits 0xA ... 0xF. </dd></dl>
<p>Referenced by <a class="el" href="group__Packet830.html#ga26a2b9d099bc2e7b83374b3318a5200c">vbi_decode_teletext_8301_local_time()</a>, and <a class="el" href="group__Cache.html#gaf22bf32b5027d5c5d34d615bc22896a3">vbi_unref_page()</a>.</p>
</div>
</div>
<a class="anchor" id="ga23963822415da5f4516a5a61113106d1"></a>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">_vbi_inline vbi_bool vbi_bcd_digits_greater </td>
<td>(</td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>bcd</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">unsigned int </td>
<td class="paramname"><em>maximum</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div><div class="memdoc">
<dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">bcd</td><td>Unsigned BCD number. </td></tr>
<tr><td class="paramname">maximum</td><td>Unsigned maximum value.</td></tr>
</table>
</dd>
</dl>
<p>Compares an unsigned packed bcd number digit-wise against a maximum value, for example 0x295959. <em>maximum</em> can contain digits 0x0 ... 0xF.</p>
<dl class="section return"><dt>Returns</dt><dd><code>TRUE</code> if any digit of <em>bcd</em> is greater than the corresponding digit of <em>maximum</em>.</dd></dl>
<dl class="section since"><dt>Since</dt><dd>0.2.28 </dd></dl>
<p>Referenced by <a class="el" href="group__Cache.html#gaf22bf32b5027d5c5d34d615bc22896a3">vbi_unref_page()</a>.</p>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.11
</small></address>
</body>
</html>
distrib
>
Mageia
>
6
>
x86_64
>
media
>
core-release
>
by-pkgid
>
2a781e5f78e233aedaa1e51ed196dcc3
>
files
>
35
