UP

Function FILL

Function FILL

構文

fill sequence item &key start end => sequence

引数と戻り値

sequence - 正常なシーケンス
item - オブジェクト
start, end - sequenceの境界インデックス指定子。 デフォルトはstart, endそれぞれ0とnil。

定義

startとendの境界内にあるsequenceの要素を、 itemに置き換えます。

例文

(fill (list 0 1 2 3 4 5) '(444)) =>  ((444) (444) (444) (444) (444) (444))
(fill (copy-seq "01234") #\e :start 3) =>  "012ee"
(setq x (vector 'a 'b 'c 'd 'e)) =>  #(A B C D E)
(fill x 'z :start 1 :end 3) =>  #(A Z Z D E)
x =>  #(A Z Z D E)
(fill x 'p) =>  #(P P P P P)
x =>  #(P P P P P)

副作用

sequenceは破壊的に修正されます。

影響

なし。

例外

sequenceが正常なシーケンスでないとき、 型type-errorのエラーを通知する準備をしなければなりません。 startが非負の整数ではないとき、 型type-errorのエラーが発生します。 endが非負の整数ではなくnilでもないとき、 型type-errorのエラーが発生します。

参考

replace, nsubstitute

備考

(fill sequence item) == (nsubstitute-if item (constantly t) sequence)

TOP, Github