• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
    • Std/lists
    • Std/alists
    • Obags
    • Std/util
    • Std/strings
      • Pretty-printing
      • Printtree
      • Base64
      • Charset-p
      • Strtok!
      • Cases
      • Concatenation
      • Html-encoding
      • Character-kinds
      • Substrings
      • Strtok
      • Equivalences
      • Url-encoding
      • Lines
      • Explode-implode-equalities
      • Ordering
      • Numbers
        • Decimal
        • Hex
          • Parse-hex-from-string
          • Hex-digit-char-p
          • Nat-to-hex-chars
          • Parse-hex-from-charlist
          • Hex-digit-chars-value
          • Hex-digit-char-value
          • Take-leading-hex-digit-chars
          • Hexify
          • Hex-digit-char-list*p
          • Hex-digit-char-listp
          • Hex-digit-string-p
          • Strval16
          • Skip-leading-hex-digits
          • Nat-to-hex-string
          • Hexify-width
          • Nonzero-hex-digit-char-p
          • Nat-to-hex-string-list
          • Revappend-nat-to-hex-chars
          • Hex-digit-to-char
          • Nat-to-hex-string-size
        • Octal
        • Binary
      • Pad-trim
      • Coercion
      • Std/strings/digit-to-char
      • Substitution
      • Symbols
    • Std/io
    • Std/osets
    • Std/basic
    • Std/system
    • Std/typed-lists
    • Std/bitsets
    • Std/testing
    • Std/typed-alists
    • Std/stobjs
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
  • Software-verification
  • Math
  • Testing-utilities

• Hex

Strval16

Interpret a string as a hexadecimal number.

Signature

(strval16 x) → value?

Arguments

x — Guard (stringp x).

Returns

value? — Type (or (natp value?) (not value?)).

For example, (strval16 "1F") is 31. If the string is empty or has any non hexadecimal digit characters (0-9, A-F, a-f), we return nil.

Definitions and Theorems

Function: strval16

(defun strval16 (x)
  (declare (xargs :guard (stringp x)))
  (declare (type string x))
  (declare (xargs :split-types t))
  (let ((acl2::__function__ 'strval16))
    (declare (ignorable acl2::__function__))
    (mbe :logic
         (let ((chars (explode x)))
           (and (consp chars)
                (hex-digit-char-list*p chars)
                (hex-digit-chars-value chars)))
         :exec
         (b* (((the unsigned-byte xl) (length x))
              ((mv (the unsigned-byte val)
                   (the unsigned-byte len))
               (parse-hex-from-string x 0 0 0 xl)))
           (and (not (eql 0 len))
                (eql len xl)
                val)))))

Theorem: return-type-of-strval16

(defthm return-type-of-strval16
  (b* ((value? (strval16 x)))
    (or (natp value?) (not value?)))
  :rule-classes :type-prescription)

Theorem: istreqv-implies-equal-strval16-1

(defthm istreqv-implies-equal-strval16-1
  (implies (istreqv x x-equiv)
           (equal (strval16 x) (strval16 x-equiv)))
  :rule-classes (:congruence))