Replaces one substring with another.
Supported Platforms: AutoCAD for Windows only; not available in AutoCAD LT for Windows, or on Mac OS and Web
Signature
(acet-str-replace find replace string [ignoreCase [useRegExp [count]]])
- find
-
Type: String
The substring to locate.
- replace
-
Type: String
The replacement substring.
- string
-
Type: String
The string to search.
- ignoreCase
-
Type: T or nil
If provided and non-nil, indicates that case insensitive comparisons should be performed.
- useRegExp
-
Type: T or nil
If provided and non-nil, indicates that regular expressions should be used for searching.
- Count
-
Type: Integer
The number of times to perform the replacement in string. If count is zero or not supplied then all occurrences are replaced.
Regular Express Syntax
This function uses the following definitions for regular expressions:
| . | Matches any single character. |
| * | Preceding item 0 or more times. |
| + | Preceding item 1 or more times. |
| ^ | Matches empty string at beginning of text. |
| $ | Matches empty string at end of text. |
| [chars] | Matches any character in the given class. If the first character is ^, match any character not in the given class. A range of character may be specified by first-last, as in [A-Z] to specify upper case alphabetic characters. |
| \( | Mark the beginning of a sub-expression. |
| \) | Mark the end of a sub-expression. |
| \digit | Matches a repeat of the text matched earlier by the sub-expression inside the nth opening parenthesis. Sub-expressions may also be referenced in replace strings. |
Return Values
Type: String
Returns the resultant string with replacements (if any) made.