Replace: Difference between revisions
(4 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
''This function is for BASIC compatibility. It is not available in pure JavaScript projects.'' | |||
Replace(''target'', ''find'', ''source''[, ''start''[, ''count''[, ''compare'']]]) | Replace(''target'', ''find'', ''source''[, ''start''[, ''count''[, ''compare'']]]) | ||
== Description == | == Description == | ||
Replace returns a string which has had one substring replaced by another a specified number of times. The required parameter, ''target'', is a string expression containing the substring to replace. The required parameter, ''find'', is the string expression to be replaced. The required parameter, ''source'', is the string expression used as the replacement. The optional parameter, ''start'', is a numeric expression that specifies the starting position of the search within the target string; if ''start'' is not provided, the search defaults to 1, which represents the first character position. The optional parameter, ''count'', is a numeric expression that specifies the number of substitutions to perform; if count is not provided -1 is used and all possible substitutions are made. The optional parameter, ''compare'', is used to specify the type of search performed | Replace returns a string which has had one substring replaced by another a specified number of times. The required parameter, ''target'', is a string expression containing the substring to replace. The required parameter, ''find'', is the string expression to be replaced. The required parameter, ''source'', is the string expression used as the replacement. The optional parameter, ''start'', is a numeric expression that specifies the starting position of the search within the target string; if ''start'' is not provided, the search defaults to 1, which represents the first character position. The optional parameter, ''count'', is a numeric expression that specifies the number of substitutions to perform; if count is not provided -1 is used and all possible substitutions are made. The optional parameter, ''compare'', is used to specify the type of search performed. | ||
== Example == | '''Table: Comparison constants''' | ||
{| class="wikitable" | |||
|- | |||
! Constant !! Value !! Description | |||
|- | |||
| vbBinaryCompare || 0 || Binary comparison case sensitive (default) | |||
|- | |||
| vbTextCompare || 1 || Textual comparison, case insensitive | |||
|} | |||
== Example (BASIC) == | |||
<pre> | <pre> | ||
Line 13: | Line 26: | ||
Message = "Good morning, class." | Message = "Good morning, class." | ||
Print Message | Print Message | ||
Message = Replace(Message, "morning", | Message = Replace(Message, "morning", "afternoon") | ||
Print Message | Print Message | ||
Ride = "big Al's big boat ride" | Ride = "big Al's big boat ride" | ||
Line 28: | Line 40: | ||
Big Al's big boat ride | Big Al's big boat ride | ||
</pre> | </pre> | ||
[[filter|Filter]] | |||
[[Category:Language Reference]] | [[Category:Language Reference]] | ||
[[Category:Strings]] | [[Category:Strings]] | ||
[[Category:BASIC Functions]] |
Latest revision as of 15:32, 25 March 2019
This function is for BASIC compatibility. It is not available in pure JavaScript projects.
Replace(target, find, source[, start[, count[, compare]]])
Description
Replace returns a string which has had one substring replaced by another a specified number of times. The required parameter, target, is a string expression containing the substring to replace. The required parameter, find, is the string expression to be replaced. The required parameter, source, is the string expression used as the replacement. The optional parameter, start, is a numeric expression that specifies the starting position of the search within the target string; if start is not provided, the search defaults to 1, which represents the first character position. The optional parameter, count, is a numeric expression that specifies the number of substitutions to perform; if count is not provided -1 is used and all possible substitutions are made. The optional parameter, compare, is used to specify the type of search performed.
Table: Comparison constants
Constant | Value | Description |
---|---|---|
vbBinaryCompare | 0 | Binary comparison case sensitive (default) |
vbTextCompare | 1 | Textual comparison, case insensitive |
Example (BASIC)
Rem Replace Example 'Replace performs string substitutions Dim Message, Ride Message = "Good morning, class." Print Message Message = Replace(Message, "morning", "afternoon") Print Message Ride = "big Al's big boat ride" Ride = Replace(Ride, "big", "Big", 1, 1) Print Ride
Output
Good morning, class. Good afternoon, class. Big Al's big boat ride