Add support for byte values, and byte buffers.

1 files changed, 102 insertions, 0 deletions

diff --git a/src/algebra/data.spad.pamphlet b/src/algebra/data.spad.pamphlet
new file mode 100644
index 00000000..b67fca76
--- /dev/null
+++ b/src/algebra/data.spad.pamphlet
@@ -0,0 +1,102 @@
+\documentclass{article}
+\usepackage{axiom}
+
+\author{Gabriel Dos~Reis}
+
+\begin{document}
+
+\begin{abstract}
+\end{abstract}
+
+\tableofcontents
+\eject
+
+\section{The Byte domain}
+
+<<domain BYTE Byte>>=
+import NonNegativeInteger
+import OutputForm
+)abbrev domain BYTE Byte
+++ Author: Gabriel Dos Reis
+++ Date Created: April 19, 2008
+++ Related Constructor:
+++ Description:
+++   Byte is the datatype of 8-bit sized unsigned integer values.
+Byte(): Public == Private where
+  Public ==> Join(OrderedSet, CoercibleTo NonNegativeInteger) with
+    coerce: NonNegativeInteger -> %
+      ++ coerce(x) injects the unsigned integer value `v' into
+      ++ the Byte algebra.  `v' must be non-negative and less than 256.
+
+  Private ==> add
+    coerce(x: NonNegativeInteger): % ==
+      byteGreaterEqual(x,256$Lisp)$Lisp => 
+        userError "integer value cannot be represented by a byte"
+      x : %
+
+    coerce(x: %): NonNegativeInteger ==
+      x : NonNegativeInteger
+
+    coerce(x: %): OutputForm ==
+      x::NonNegativeInteger::OutputForm
+
+    x < y ==
+      byteLessThan(x,y)$Lisp
+@
+
+
+\section{The ByteArray domain}
+
+<<domain BYTEARY ByteArray>>=
+import PrimitiveArray
+import Byte
+)abbrev domain BYTEARY ByteArray
+++ Author: Gabriel Dos Reis
+++ Date Created: April 19, 2008
+++ Related Constructor:
+++ Description:
+++   ByteArray provides datatype for fix-sized buffer of bytes.
+ByteArray() == PrimitiveArray Byte
+@
+
+
+\section{License}
+<<license>>=
+--Copyright (C) 2007-2008, Gabriel Dos Reis.
+--All rights reserved.
+--
+--Redistribution and use in source and binary forms, with or without
+--modification, are permitted provided that the following conditions are
+--met:
+--
+--    - Redistributions of source code must retain the above copyright
+--      notice, this list of conditions and the following disclaimer.
+--
+--    - Redistributions in binary form must reproduce the above copyright
+--      notice, this list of conditions and the following disclaimer in
+--      the documentation and/or other materials provided with the
+--      distribution.
+--
+--    - Neither the name of The Numerical Algorithms Group Ltd. nor the
+--      names of its contributors may be used to endorse or promote products
+--      derived from this software without specific prior written permission.
+--
+--THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+--IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+--TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+--PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+--OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+--EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+--PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+--PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+--LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+--NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+--SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+@
+
+
+<<*>>=
+<<license>>
+<<domain BYTE Byte>>
+<<domain BYTEARY ByteArray>>
+@