vl-string-position (AutoLISP)

文字列内の指定された ASCII コードの文字を検索します。

サポートされているプラットフォーム: Windows および Mac OS

構文と要素

(vl-string-position char-code str [start-pos [from-end-p]])

char-code

タイプ: 整数型

検索する文字を表す数値。

str

タイプ: 文字列

検索する文字値。

start-pos

タイプ: 整数型

文字列内の検索開始位置(先頭の文字は 0)。省略した場合は 0(ゼロ)。

from-end-p

タイプ: T または nil

この引数に T を指定した場合、文字列の終端から検索が開始され、pos まで逆方向に検索されます。

戻り値

タイプ: 整数または nil

見つかった char-code に対応する文字の、文字列の先頭からの位置を表す整数、文字が見つからなかった場合は nil。

例

(vl-string-position (ascii "z") "azbdc")
1

(vl-string-position 122 "azbzc")
1

(vl-string-position (ascii "x") "azbzc")
nil

次の例では、検索対象の文字列内に 2 つの "z" が存在します。先頭の文字の位置を 0(ゼロ)として左から右に数えると、一方の z の位置は 1、他方の z の位置は 3 です。

(vl-string-position (ascii "z") "azbzlmnqc")
1

左から右に検索(既定)すると、vl-string-position 関数は、位置 1 の "z" を最初に検出します。しかし、次の例のように右から左に検索すると、位置 3 の "z" が最初に検出されます。

(vl-string-position (ascii "z") "azbzlmnqc" nil T)
3