		Search-engine friendly clone of the ACL2 documentation.

Parser-interface

Parse-from-bytes+

Parse UTF-8 bytes into a CST.

Signature
(parse-from-bytes+ leo-bytes) → (mv tree lexemes)
Arguments: leo-bytes — Guard (nat-listp leo-bytes).
Returns: tree — Type (abnf::tree-resultp tree).; lexemes — Type (abnf::tree-listp lexemes).

Lexes, tokenizes, and parses a Leo source file expressed as a list of UTF-8 bytes. Returns a file CST, and the full list of lexemes, including comments and whitespace.

If any step fails, returns a reserr. The parse consumes all the bytes or a reserr is returned.

Definitions and Theorems

Function: parse-from-bytes+

(defun parse-from-bytes+ (leo-bytes)
  (declare (xargs :guard (nat-listp leo-bytes)))
  (let ((__function__ 'parse-from-bytes+))
    (declare (ignorable __function__))
    (b* ((lexemes-or-err (lexemize-leo-from-bytes leo-bytes)))
      (lexemes-to-cst+ "file" lexemes-or-err))))

Theorem: tree-resultp-of-parse-from-bytes+.tree

(defthm tree-resultp-of-parse-from-bytes+.tree
  (b* (((mv ?tree ?lexemes)
        (parse-from-bytes+ leo-bytes)))
    (abnf::tree-resultp tree))
  :rule-classes :rewrite)

Theorem: tree-listp-of-parse-from-bytes+.lexemes

(defthm tree-listp-of-parse-from-bytes+.lexemes
  (b* (((mv ?tree ?lexemes)
        (parse-from-bytes+ leo-bytes)))
    (abnf::tree-listp lexemes))
  :rule-classes :rewrite)