\section{BITCMP Bitwise Boolean Complement Operation}

\subsection{Usage}

Performs a bitwise binary complement operation on the argument and
returns the result.  The syntax for its use is
\begin{verbatim}
   y = bitcmp(a)
\end{verbatim}
where \verb|a| is an unsigned integer arrays.  This version of the command
uses as many bits as required by the type of \verb|a|.  For example, if 
\verb|a| is an \verb|uint8| type, then the complement is formed using 8 bits.
The second form of \verb|bitcmp| allows you to specify the number of bits
to use, 
\begin{verbatim}
   y = bitcmp(a,n)
\end{verbatim}
in which case the complement is taken with respect to \verb|n| bits. 
\subsection{Example}

Generally, the bitwise complement of a number is known as its 
ones-complement.  Here are some examples.  First we take the binary
complement using 8 bits.
\begin{verbatim}
--> bitcmp(uint8(55))
ans = 
  <uint8>  - size: [1 1]
 200  

\end{verbatim}
Then the complement using 16 bits
\begin{verbatim}
--> bitcmp(uint16(55))
ans = 
  <uint16>  - size: [1 1]
 65480  

\end{verbatim}
Finally, we look for the 4 bit complement
\begin{verbatim}
--> bitcmp(3,4)
ans = 
  <int32>  - size: [1 1]
 12  

\end{verbatim}
