UP

Function STRING-UPCASE, STRING-DOWNCASE, STRING-CAPITALIZE, NSTRING-UPCASE, NSTRING-DOWNCASE, NSTRING-CAPITALIZE

Function STRING-UPCASE, STRING-DOWNCASE, STRING-CAPITALIZE, NSTRING-UPCASE, NSTRING-DOWNCASE, NSTRING-CAPITALIZE

構文

string-upcase string &key start end => cased-string
string-downcase string &key start end => cased-string
string-capitalize string &key start end => cased-string
nstring-upcase string &key start end => string
string-downcase string &key start end => string
string-capitalize string &key start end => string

引数と戻り値

string - string-designator。ただし、 nstring-upcase, nstring-downcase, nstring-capitalizeの場合は、 文字列出なければならない。
start, end - 文字列の境界インデックス指定子。 startとendの標準値はそれぞれ0とnil。
cased-string - 文字列。

定義

string-upcase, string-downcase, string-capitalize, nstring-upcase, nstring-downcase, nstring-capitalizeは、 文字列のstart, endの境界間の列のケース（大文字小文字）を次のように変更します。

• string-upcase
string-upcaseは、stringの全ての小文字を、 対応する大文字に全て置き換えた文字列を返却します。 正確には、返却された文字列の各文字は、 stringの各文字に対して関数char-upcaseの実行によって生成されたものです。

• string-downcase
string-downcaseは、string-upcaseと似ていますが、 全ての大文字を小文字に置き換えるところが違っています (char-downcaseを使用します）。

• string-capitalize
string-capitalizeは、すべての単語wordについて、 wordの最初の文字が大文字であり、 その他の文字が小文字であるような文字列のコピーを作成します。 string-capitalizeでは、 英数字からなる連続した文字列の両端を、 英数字以外の文字か、 または文字列の終端で区切ったものを単語wordと定義しています。

• nstring-upcase, nstring-downcase, nstring-capitalize
nstring-upcase, nstring-downcase, nstring-capitalizeは、 それぞれstring-upcase, string-downcase, string-capitalizeと 同一ですが、stringを変更するところが違っています。

string-upcase, string-downcase, string-capitalizeは、 stringを変更しません。 しかし文字列に変更する文字がない場合は、 処理系の判断により、返却値はstringかあるいはそのコピーのどちらかになります。

例文

(string-upcase "abcde") =>  "ABCDE"
(string-upcase "Dr. Livingston, I presume?")
=>  "DR. LIVINGSTON, I PRESUME?"
(string-upcase "Dr. Livingston, I presume?" :start 6 :end 10)
=>  "Dr. LiVINGston, I presume?"
(string-downcase "Dr. Livingston, I presume?")
=>  "dr. livingston, i presume?"

(string-capitalize "elm 13c arthur;fig don't") =>  "Elm 13c Arthur;Fig Don'T"
(string-capitalize " hello ") =>  " Hello "
(string-capitalize "occlUDeD cASEmenTs FOreSTAll iNADVertent DEFenestraTION")
=>   "Occluded Casements Forestall Inadvertent Defenestration"
(string-capitalize 'kludgy-hash-search) =>  "Kludgy-Hash-Search"
(string-capitalize "DON'T!") =>  "Don'T!"    ;not "Don't!"
(string-capitalize "pipe 13a, foo16c") =>  "Pipe 13a, Foo16c"

(setq str (copy-seq "0123ABCD890a")) =>  "0123ABCD890a"
(nstring-downcase str :start 5 :end 7) =>  "0123AbcD890a"
str =>  "0123AbcD890a"

副作用

nstring-upcase, nstring-downcase, nstring-capitalizeは、 新しい文字列を構築するのではなく、stringを変更します。

影響

なし。

例外

なし。

参考

char-upcase, char-downcase.

備考

返却値は常にstringと同じ長さです。

TOP, Github