vl-string-position (AutoLISP)

Looks for a character with the specified ASCII code in a string

Supported Platforms: Windows and Mac OS

Signature

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

Type: Integer

A numeric value representation of the character to be searched.

str

Type: String

The textual value to be searched.

start-pos

Type: Integer

The position to begin searching from in the string (first character is 0); 0 if omitted.

from-end-p

Type: T or nil

If T is specified for this argument, the search begins at the end of the string and continues backward to pos.

Return Values

Type: Integer or nil

An integer representing the displacement at which char-code was found from the beginning of the string; nil if the character was not found.

Examples

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

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

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

The search string used in the following example contains two “z” characters. Reading from left to right, with the first character being displacement 0, there is one z at displacement 1 and another z at displacement 3:

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

Searching from left to right (the default), the “z” in position 1 is the first one vl-string-position encounters. But when searching from right to left, as in the following example, the “z” in position 3 is the first one encountered:

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