		Search-engine friendly clone of the ACL2 documentation.

Oslib

Ls-subdirs!

Get a listing of the subdirectories of a directory, or cause a hard error.

Signature
(ls-subdirs! path &key (state 'state)) → (mv val state)
Arguments: path — Guard (stringp path).
Returns: val — Type (string-listp val).; state — Type (state-p1 state), given (force (state-p1 state)).

This is just a wrapper for ls-subdirs that causes a hard error if there are any problems.

Definitions and Theorems

Function: ls-subdirs!-fn

(defun ls-subdirs!-fn (path state)
  (declare (xargs :stobjs (state)))
  (declare (xargs :guard (stringp path)))
  (let ((__function__ 'ls-subdirs!))
    (declare (ignorable __function__))
    (b* (((mv err val state) (ls-subdirs path))
         ((when err)
          (er hard? 'ls-subdirs! "~@0" err)
          (mv nil state)))
      (mv val state))))

Theorem: string-listp-of-ls-subdirs!.val

(defthm string-listp-of-ls-subdirs!.val
  (b* (((mv ?val acl2::?state)
        (ls-subdirs!-fn path state)))
    (string-listp val))
  :rule-classes :rewrite)

Theorem: state-p1-of-ls-subdirs!.state

(defthm state-p1-of-ls-subdirs!.state
  (implies (force (state-p1 state))
           (b* (((mv ?val acl2::?state)
                 (ls-subdirs!-fn path state)))
             (state-p1 state)))
  :rule-classes :rewrite)