CLCS
src report error
Index
simple-string-p Strings Dictionary string
Accessor

char, schar

char string index ⇒ character

schar string index ⇒ character

(setf (char string index) new-character)
(setf (schar string index) new-character)

Arguments and Values

stringfor char, a string; for schar, a simple string.
indexa valid array index for the string.
character, new-charactera character.

Description

char and schar access the element of string specified by index.

char ignores fill pointers when accessing elements.

Examples

 (setq my-simple-string (make-string 6 :initial-element #\A)) ⇒  "AAAAAA"
 (schar my-simple-string 4) ⇒  #\A
 (setf (schar my-simple-string 4) #\B) ⇒  #\B
 my-simple-string ⇒  "AAAABA"
 (setq my-filled-string
       (make-array 6 :element-type 'character
                     :fill-pointer 5
                     :initial-contents my-simple-string))
⇒  "AAAAB"
 (char my-filled-string 4) ⇒  #\B
 (char my-filled-string 5) ⇒  #\A
 (setf (char my-filled-string 3) #\C) ⇒  #\C
 (setf (char my-filled-string 5) #\D) ⇒  #\D
 (setf (fill-pointer my-filled-string) 6) ⇒  6
 my-filled-string ⇒  "AAACBD"

See Also

aref, elt,

Compiler Terminology

Notes

 (char s j) ≡ (aref (the string s) j)

Backlinks

aref, bit, sbit, Function Call Forms as Places, Required Kinds of Specialized Arrays, Sharpsign, Strings Dictionary, Symbols in the COMMON-LISP Package