help/info/bit2hex.html

   1 <!--
   2  Copyright (c) 2000-2015 Ericsson Telecom AB
   3
   4  All rights reserved. This program and the accompanying materials
   5  are made available under the terms of the Eclipse Public License v1.0
   6  which accompanies this distribution, and is available at
   7  http://www.eclipse.org/legal/epl-v10.html
   8  -->
   9 <html>
  10 <head>
  11 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  12 <meta http-equiv="Content-Language" content="en-us">
  13 <title>bit2hex</title>
  14 </head>
  15 <body bgcolor="#DAD3C5" vlink="#0094D2" link="#003258">
  16 <table align="left" border="0" cellspacing="0" cellpadding="0" valign=top>
  17   <tr>
  18     <td width=105 height=40><a href="https://projects.eclipse.org/projects/tools.titan"><img src="../images/titan_transparent.gif" border=0 width=105 height=40 align="left" alt="Titan"></a></td>
  19   </tr>
  20 </table>
  21 <table border="0" align="right" cellpadding="0" cellspacing="0">
  22   <tr>
  23     <td><a href="../titan_main.html" alt="contents"><img border="0" src="../images/ao.jpg" width="53" height="40"></a></td>
  24     <td><a href="../titan_index.html" alt="index"><img border="0" src="../images/up.jpg" width="53" height="40"></a></td>
  25     <td><a alt="previous" href="apply.html"><img border="0" src="../images/left.jpg" width="53" height="40"></a></td>
  26     <td><a alt="next" href="bit2int.html"><img border="0" src="../images/right.jpg" width="53" height="40"></a></td>
  27   </tr>
  28 </table>
  29 <p><br clear="all">
  30 </p>
  31 <hr>
  32 <h1>bit2hex</h1>
  33 <hr align="left" width="75%">
  34 <p>This function converts a single <b><font face="Courier New">bitstring</font></b> value to a single <b><font face="Courier New">hexstring</font></b>. The resulting <b><font
  35   face="Courier New">hexstring</font></b> represents the same value as the <b><font face="Courier New">bitstring</font></b>.
  36 <p>For the purpose of this conversion, a bitstring should be converted into a hexstring, where the bitstring is divided into groups of four bits beginning with the rightmost bit. Each group of
  37 four bits is converted into a hex digit as follows:
  38 <p>'0000'B -> '0'H,&nbsp;&nbsp;&nbsp;'0001'B -> '1'H,&nbsp;&nbsp;&nbsp;'0010'B -> '2'H,&nbsp;&nbsp;&nbsp;'0011'B -> '3'H,&nbsp;&nbsp;&nbsp;'0100'B -> '4'H,&nbsp;&nbsp;&nbsp;'0101'B -> '5'H,<br>
  39 <p>'0110'B -> '6'H,&nbsp;&nbsp;&nbsp;'0111'B -> '7'H,&nbsp;&nbsp;&nbsp;'1000'B -> '8'H,&nbsp;&nbsp;&nbsp;'1001'B -> '9'H,&nbsp;&nbsp;&nbsp;'1010'B -> 'A'H,&nbsp;&nbsp;&nbsp;'1011'B -> 'B'H,<br>
  40 <p>'1100'B -> 'C'H,&nbsp;&nbsp;&nbsp;'1101'B -> 'D'H,&nbsp;&nbsp;&nbsp;'1110'B ->'E'H,&nbsp;and&nbsp;'1111'B -> 'F'H.<br>
  41 <p>When the leftmost group of bits does contain less than 4 bits, this group is filled with '0'B from the left until it contains exactly 4 bits and is converted afterwards. The consecutive order
  42 of hex digits in the resulting hexstring is the same as the order of groups of 4 bits in the bitstring.
  43 <hr align="left" width="50%">
  44 <p>Related keyword:</p>
  45 <ul>
  46   <li><b><font face="Courier New" size="4" color="#003258"> <a href="bitstring.html">bitstring</a></font></b></li>
  47   <li><b><a href="hexstring.html"><font face="Courier New" size="4" color="#003258"> hexstring</font></a></b></li>
  48 </ul>
  49 <hr align="left" width="50%">
  50 <div align="center">
  51 <center>
  52 <table border="0" width="90%" bgcolor="#FFB599" cellpadding="4">
  53   <tr>
  54     <td width="100%">
  55     <h3 align="center"><font face="Courier New" color="#003258" size="5"><b>bit2hex</b></font><font face="Courier New" color="#003258" size="5"><b>(</b></font><b>bitstring</b><i> value</i><font
  56       face="Courier New" color="#003258" size="5"><b>) return hexstring</b></font></h3>
  57     </td>
  58   </tr>
  59 </table>
  60 </center>
  61 </div>
  62 <ul>
  63 </ul>
  64 <hr align="left" width="25%">
  65 <p>Example 1:</p>
  66 <p><font face="Courier New"> const hexstring c_ganz := bit2hex ('111010111'B); </font></p>
  67 <p>The constant called c_ganz will have the hexadecimal value 1D7. The bit string is divided in groups of four starting from the right and converted to hexadecimal digits. When the last group has
  68 less than four bits it will be padded with leading zeros.
  69 <hr align="left" width="25%">
  70 </body>
  71 </html>