unsignedinteger Class Reference


The unsignedinteger class defines all the methods needed to handle address, hexadecimal values, bitwise and mask computations. The unsignedinteger class is a subclass of the scalar class. Internally, an unsignedinteger is defined as a C/C++ type long long, ie always 64 bits as well on an ILP32 CPU than on a LP64 CPU.  Only bit operations, addition and subtraction are allowed. The unsignedinteger value itself is stored in the car part of a wwlisp cell, beginning at the lowest address, and cannot be seen completely by the carvalue function on a 32 bits machine. unsignedinteger are printed in hexadecimal, and hexadecimal values, when read, are stored as unsignedinteger.


  • unsignedinteger-+
  • unsignedinteger--
  • unsignedinteger-<
  • unsignedinteger-=
  • unsignedinteger->
  • unsignedinteger-base64
  • unsignedinteger-binary
  • unsignedinteger-bit-and
  • unsignedinteger-bit-nand
  • unsignedinteger-bit-nor
  • unsignedinteger-bit-not
  • unsignedinteger-bit-or
  • unsignedinteger-bit-shift-left
  • unsignedinteger-bit-shift-right
  • unsignedinteger-bit-xor
  • unsignedinteger-constructor
  • unsignedinteger-float
  • unsignedinteger-format
  • unsignedinteger-hexadecimal
  • unsignedinteger-integer
  • unsignedinteger-string
  • unsignedinteger-unsignedinteger
  • unsignedinteger-zerop

  • List of all Inherited Classes

  • scalar
  • class

  • unsignedinteger-+

    (+ arg1 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unlimited number of integers
    Return Value an unsignedinteger
    Description returns the result of the successive addition of the second argument to the first, the third to the result, the fourth to the result, and so on
    Example (+ 0x0 32) => 0x20

    unsignedinteger--

    (- arg1 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unlimited number of integers
    Return Value an unsignedinteger
    Description returns the result of the successive subtraction of the second argument from the first, the third from the result, the fourth from the result, and so on
    Example (- 0x0 32) =>0xffffffe0

    unsignedinteger-<

    (< arg1 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unlimited number of unsignedintegers, floats or integers
    Return Value t or nil
    Description returns t if the series of arguments is strictly increasing
    Example (< 0x1 2 3.0) => t

    unsignedinteger-=

    (= arg1 arg2 )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, float or integer
    Return Value t or nil
    Description returns t if the values of the arguments are numerically equal
    Example (= 0x1 1.0) => t

    unsignedinteger->

    (> arg1 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unlimited number of unsignedintegers, floats or integers
    Return Value t or nil
    Description returns t if the series of arguments is strictly decreasing
    Example (> 0x3 2 1.0) => t

    unsignedinteger-base64

    (base64 arg )

    Function Type subr
    Arguments an unsignedinteger object
    Return Value a string
    Description returns a string containing the base64 translation of the unsignedinteger; the length is fixed to 11 characters for the 64 bits unsignedintegers; endianity is unchanged
    Example (base64 0) => "AAAAAAAAAAA"

    unsignedinteger-binary

    (binary arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value a binary block
    Description returns a binary block of 8 bytes length containg the unsigned integer byte pattern; the result depends on the endianness of the CPU
    Example (ord(binary 0xff)) => (255 0 0 0 0 0 0 0)

    unsignedinteger-bit-and

    (bit-and arg1 arg2 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, an unlimited number of unsignedinteger
    Return Value an unsignedinteger
    Description returns an unsignedinteger which is the result of the bitwise 'and' of the second argument on the first, then of the third on the result and so on;
    Example (bit-and 0xff 0xff0) => 0xf0

    unsignedinteger-bit-nand

    (bit-nand arg1 arg2 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, an unlimited number of unsignedinteger
    Return Value an unsignedinteger
    Description makes an unsignedinteger which is the result of the bitwise 'and' of the second argument on the first, then of the third on the result and so on; the final result is inverted before to be returned
    Example (bit-nand 0xff 0xff0) => 0xffffff0f

    unsignedinteger-bit-nor

    (bit-nor arg1 arg2 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, an unlimited number of unsignedinteger
    Return Value an unsignedinteger
    Description makes an unsignedinteger which is the result of the bitwise 'or' of the second argument on the first, then of the third on the result and so on; the final result is inverted before to be returned
    Example (bit-nor 0xff 0xff0) => 0xfffff000

    unsignedinteger-bit-not

    (bit-not arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value an unsignedinteger
    Description returns an unsignedinteger where all the bits of the unsignedinteger given as argument are inverted
    Example (bit-not 0xf) => 0xfffffff0

    unsignedinteger-bit-or

    (bit-or arg1 arg2 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, an unlimited number of unsignedinteger
    Return Value an unsignedinteger
    Description returns an unsignedinteger which is the result of the bitwise 'or' of the second argument on the first, then of the third on the result and so on;
    Example (bit-or 0xff 0xff0) => 0xfff

    unsignedinteger-bit-shift-left

    (bit-shift-left arg1 arg2 )

    Function Type subr
    Arguments an unsignedinteger, an integer
    Return Value an unsignedinteger
    Description returns an unsignedinteger which is a copy of the first argument where all the bits are shifted to the left by a number always positive given as second argument; the greatest shift allowed is one bit less than the size of the unsignedinteger
    Example (bit-shift-left 0x1 31) => 0x80000000

    unsignedinteger-bit-shift-right

    (bit-shift-right arg1 arg2 )

    Function Type subr
    Arguments an unsignedinteger, an integer
    Return Value an unsignedinteger
    Description returns an unsignedinteger which is a copy of the first argument where all the bits are shifted to the right by a number always positive given as second argument; the greatest shift allowed is one bit less than the size of the unsignedinteger
    Example (bit-shift-right 0x80000000 31) => 0x1

    unsignedinteger-bit-xor

    (bit-xor arg1 arg2 ... argn )

    Function Type subr
    Arguments an unsignedinteger, an unsignedinteger, an unlimited number of unsignedinteger
    Return Value an unsignedinteger
    Description returns an unsignedinteger which is the result of the bitwise 'xor' of the second argument on the first, then of the third on the result and so on;
    Example (bit-xor 0xff 0xff0 0xf) => 0xf00

    unsignedinteger-constructor

    (make-instance unsignedinteger)

    Function Type subr
    Arguments none
    Return Value an integer
    Description returns an integer initialized at zero; never use directly integer-constructor, but do it always through make-instance or implicit creation
    Example (make-instance unsignedinteger) => 0x0

    unsignedinteger-float

    (float arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value a float
    Description returns a float containg the value which was stored in the unsignedinteger
    Example (float 0xff) => 255.000000

    unsignedinteger-format

    (format arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value a string
    Description returns a string containing the formatted value of the object passed as argument; is the default formatter of the class
    Example (format 0xff) => "0xff"

    unsignedinteger-hexadecimal

    (hexadecimal arg )

    Function Type subr
    Arguments an unsignedinteger object
    Return Value a string
    Description returns a string containing the hexadecimal translation of the unsignedinteger; the length is variable with the leading zeroes suppressed; endianity is MSB: most significant bits are on the left;
    Example (hexadecimal 240) => "f0"

    unsignedinteger-integer

    (integer arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value an integer
    Description returns an signed integer containing the positive or negative integer value of the argument; the maximum and minimum values are defined by the architecture of the CPU: either 32 or 64 bits, and how the sign is represented
    Example (integer 0x80000000) => -2147483648

    unsignedinteger-string

    (string arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value a string
    Description returns a string containing the edited value of the unsignedinteger given as argument
    Example (string 0x0) => "0x0"

    unsignedinteger-unsignedinteger

    (unsignedinteger arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value an unsignedinteger
    Description returns the argument; needed when converting an argument which can be integer or unsignedinteger
    Example (unsignedinteger x)

    unsignedinteger-zerop

    (zerop arg )

    Function Type subr
    Arguments an unsignedinteger
    Return Value t or nil
    Description returns t if the argument is 0x0, nil otherwise
    Example (zerop x)

    Updated 29/11/2008 Copyright © 2008 Walther Waeles
    SourceForge.net Logo