• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
    • Std/lists
    • Std/alists
    • Obags
    • Std/util
    • Std/strings
    • Std/io
      • Open-channel-lemmas
      • Std/io/read-char$
      • Std/io/read-object
      • Std/io/open-output-channel
      • Unsound-read
      • Read-string
      • Read-bytes$
        • Read-64ule
        • Read-64ube
        • Read-64sle
        • Read-64sbe
        • Read-32ule
        • Read-32sle
        • Read-32sbe
        • Read-32ube
        • Read-16sle
        • Read-16sbe
        • Read-16ule
        • Read-16ube
        • Read-8s
        • Combine-functions
      • File-measure
      • Read-bytes$-n
      • Std/io/read-byte$
      • Std/io/open-input-channel
      • Read-file-lines-no-newlines
      • Print-compressed
      • Nthcdr-bytes
      • Read-file-lines
      • Std/io/close-output-channel
      • Read-file-characters
      • Read-file-bytes
      • Print-legibly
      • Std/io/close-input-channel
      • Read-file-objects
      • Logical-story-of-io
      • Take-bytes
      • Std/io/peek-char$
      • Read-file-characters-rev
      • Read-file-as-string
      • Std/io/write-byte$
      • Std/io/set-serialize-character
      • Std/io/print-object$
      • Std/io/princ$
      • Std/io/read-file-into-string
      • *file-types*
    • 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

• Read-bytes$

Read-16ule

(read-16ule channel state) reads a 16-bit, unsigned, little-endian value from the input channel.

Definitions and Theorems

Function: read-16ule

(defun read-16ule (channel state)
  (declare (xargs :guard (and (state-p state)
                              (symbolp channel)
                              (open-input-channel-p channel
                                                    :byte state))))
  (b* (((mv x1 state)
        (read-byte$ channel state))
       ((mv x2 state)
        (read-byte$ channel state))
       ((unless x1) (mv nil state))
       ((unless x2) (mv 'fail state)))
    (mv (combine16u x2 x1) state)))

Theorem: read-16ule-unsigned-byte

(defthm read-16ule-unsigned-byte
  (implies (and (force (state-p1 state))
                (force (open-input-channel-p1 channel
                                              :byte state))
                (force (symbolp channel))
                (mv-nth 0 (read-16ule channel state))
                (not (equal (mv-nth 0 (read-16ule channel state))
                            'fail)))
           (unsigned-byte-p 16
                            (mv-nth 0 (read-16ule channel state)))))

Theorem: read-16ule-integer

(defthm read-16ule-integer
  (implies (and (mv-nth 0 (read-16ule channel state))
                (not (equal (mv-nth 0 (read-16ule channel state))
                            'fail)))
           (integerp (mv-nth 0 (read-16ule channel state)))))

Theorem: read-16ule-range

(defthm read-16ule-range
  (implies (and (force (state-p1 state))
                (force (open-input-channel-p1 channel
                                              :byte state))
                (force (symbolp channel))
                (mv-nth 0 (read-16ule channel state))
                (not (equal (mv-nth 0 (read-16ule channel state))
                            'fail)))
           (and (<= 0 (mv-nth 0 (read-16ule channel state)))
                (< (mv-nth 0 (read-16ule channel state))
                   65536)
                (< (mv-nth 0 (read-16ule channel state))
                   (expt 2 16))))
  :rule-classes :linear)

Theorem: read-16ule-state

(defthm read-16ule-state
  (implies (and (force (state-p1 state))
                (force (open-input-channel-p1 channel
                                              :byte state))
                (force (symbolp channel)))
           (state-p1 (mv-nth 1 (read-16ule channel state)))))

Theorem: read-16ule-open-input-channel-p1

(defthm read-16ule-open-input-channel-p1
  (implies (and (force (state-p1 state))
                (force (open-input-channel-p1 channel
                                              :byte state))
                (force (symbolp channel)))
           (open-input-channel-p1
                channel
                :byte (mv-nth 1 (read-16ule channel state)))))