• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Community
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
      • Theories
      • Rule-classes
      • Proof-builder
      • Recursion-and-induction
      • Hons-and-memoization
      • Events
      • Parallelism
      • History
      • Programming
        • Defun
        • Declare
        • System-utilities
        • Stobj
        • State
        • Mutual-recursion
        • Memoize
        • Mbe
        • Io
        • Defpkg
        • Apply$
        • Loop$
        • Programming-with-state
        • Arrays
        • Characters
        • Time$
        • Defconst
        • Fast-alists
        • Defmacro
        • Loop$-primer
        • Evaluation
        • Guard
        • Equality-variants
        • Compilation
        • Hons
        • ACL2-built-ins
        • Developers-guide
        • System-attachments
        • Advanced-features
        • Set-check-invariant-risk
        • Numbers
        • Efficiency
        • Irrelevant-formals
        • Introduction-to-programming-in-ACL2-for-those-who-know-lisp
        • Redefining-programs
        • Lists
        • Invariant-risk
        • Errors
        • Defabbrev
        • Conses
        • Alists
        • Set-register-invariant-risk
        • Strings
          • Std/strings
            • Pretty-printing
            • Printtree
            • Base64
            • Charset-p
            • Strtok!
            • Cases
              • Icharlisteqv
              • Upcase-charlist
              • Downcase-charlist
              • Upcase-string
              • Istreqv
              • Downcase-char
              • Upcase-char
              • Ichareqv
              • Downcase-string
              • Upcase-first-charlist
                • Downcase-first-charlist
                • Downcase-first
                • Upcase-first
                • Down-alpha-p
                • Up-alpha-p
                • Upcase-char-str
                • Downcase-char-str
                • Upcase-string-list
                • Downcase-string-list
              • Concatenation
              • Character-kinds
              • Html-encoding
              • Substrings
              • Strtok
              • Equivalences
              • Url-encoding
              • Lines
              • Explode-implode-equalities
              • Ordering
              • Numbers
              • Pad-trim
              • Coercion
              • Std/strings/digit-to-char
              • Substitution
              • Symbols
            • String-listp
            • Stringp
            • Length
            • Search
            • Remove-duplicates
            • Position
            • Coerce
            • Concatenate
            • Reverse
            • String
            • Subseq
            • Substitute
            • String-upcase
            • String-downcase
            • Count
            • Char
            • String<
            • String-equal
            • String-utilities
            • String-append
            • String>=
            • String<=
            • String>
            • Hex-digit-char-theorems
            • String-downcase-gen
            • String-upcase-gen
          • Program-wrapper
          • Get-internal-time
          • Basics
          • Packages
          • Oracle-eval
          • Defmacro-untouchable
          • <<
          • Primitive
          • Revert-world
          • Unmemoize
          • Set-duplicate-keys-action
          • Symbols
          • Def-list-constructor
          • Easy-simplify-term
          • Defiteration
          • Fake-oracle-eval
          • Defopen
          • Sleep
        • Operational-semantics
        • Real
        • Start-here
        • Miscellaneous
        • Output-controls
        • Bdd
        • Macros
        • Installation
        • Mailing-lists
      • Interfacing-tools
      • Hardware-verification
      • Software-verification
      • Math
      • Testing-utilities
    • Cases

    Upcase-first-charlist

    Convert the first character of a character list to upper case.

    Signature
    (upcase-first-charlist x) → upcased
    Arguments
    x — Guard (character-listp x).
    Returns
    upcased — Type (character-listp upcased).

    Definitions and Theorems

    Function: upcase-first-charlist

    (defun upcase-first-charlist (x)
      (declare (xargs :guard (character-listp x)))
      (let ((acl2::__function__ 'upcase-first-charlist))
        (declare (ignorable acl2::__function__))
        (mbe :logic
             (if (atom x)
                 nil
               (cons (upcase-char (car x))
                     (make-character-list (cdr x))))
             :exec (cond ((atom x) nil)
                         ((down-alpha-p (car x))
                          (cons (upcase-char (car x)) (cdr x)))
                         (t x)))))

    Theorem: character-listp-of-upcase-first-charlist

    (defthm character-listp-of-upcase-first-charlist
      (b* ((upcased (upcase-first-charlist x)))
        (character-listp upcased))
      :rule-classes :rewrite)

    Theorem: charlisteqv-implies-equal-upcase-first-charlist-1

    (defthm charlisteqv-implies-equal-upcase-first-charlist-1
      (implies (charlisteqv x x-equiv)
               (equal (upcase-first-charlist x)
                      (upcase-first-charlist x-equiv)))
      :rule-classes (:congruence))

    Theorem: icharlisteqv-implies-icharlisteqv-upcase-first-charlist-1

    (defthm icharlisteqv-implies-icharlisteqv-upcase-first-charlist-1
      (implies (icharlisteqv x x-equiv)
               (icharlisteqv (upcase-first-charlist x)
                             (upcase-first-charlist x-equiv)))
      :rule-classes (:congruence))

    Theorem: upcase-first-charlist-when-atom

    (defthm upcase-first-charlist-when-atom
      (implies (atom x)
               (equal (upcase-first-charlist x) nil)))

    Theorem: len-of-upcase-first-charlist

    (defthm len-of-upcase-first-charlist
      (equal (len (upcase-first-charlist x))
             (len x)))

    Theorem: consp-of-upcase-first-charlist

    (defthm consp-of-upcase-first-charlist
      (equal (consp (upcase-first-charlist x))
             (consp x)))

    Theorem: upcase-first-charlist-under-iff

    (defthm upcase-first-charlist-under-iff
      (iff (upcase-first-charlist x)
           (consp x)))