regular expression | NN 4 IE J3 ECMA n/a | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
A regular expression object is an instance of the RegExp object. Each regular expression object consists of a pattern that is used to locate matches within a string. Patterns for a regular expression can be simple strings or significantly more powerful expressions that use a notation that is essentially a language unto itself. The implementation of regular expressions in JavaScript 1.2 is very similar to the way they are implemented in Perl. You can read more about these concepts in books covering JavaScript 1.2. To create a regular expression object, surround the pattern with forward slashes, and assign the whole expression to a variable. For example, the following statement creates a regular expression whose pattern is a simple word: var re = /greet/ The re variable can then be used as a parameter in a variety of methods that search for the pattern within some string (you may also use an expression directly as a method parameter, rather than assigning it to a variable). Regular expression notation also consists of a number of metacharacters that stand in for sometimes complex ideas, such as the boundary on either side of a word, any numeral, or one or more characters. For example, to search for the pattern of characters shown above but only when the pattern is a word (and not part of a word such as greetings), the regular expression notation uses the metacharacters to indicate that the pattern includes word boundaries on both sides of the pattern: var re = /\bgreet\b/
When you create a regular expression, you may optionally wire the expression to work globally (as you probably do if the regular expression is doing a search-and-replace operation with a method) and to ignore case in its matches. The modifiers that turn on these switches are the letters g and i. They may be used by themselves or together as gi. Once you have established a pattern with the regular expression notation, all the action takes place in the regular expression object methods and the String object methods that accept regular expression parameters. | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Creating a regular expression Objectvar regExpressionObj = /pattern/ [g | i | gi] var regExpressionObj = new RegExp(["pattern", ["g" | "i" | "gi"]]) |
global, ignoreCase | NN 4 IE J3 ECMA n/a |
Read-only | |
Returns whether the object had the g or i modifiers set when it was created. If a regular expression object has both modifiers set (gi), you must still test for each property individually. | |
Exampleif (myRE.global && myRE.ignoreCase) { ... } | |
Value Boolean. |
lastIndex | NN 4 IE J3 ECMA n/a |
Read/Write | |
The zero-based index value of the character within the string where the next search for the pattern begins. In a new search, the value is zero. You can also set the value manually if you wish to start at a different location or skip some characters. | |
ExamplemyRE.lastIndex = 30 | |
Value Integer. |
source | NN 4 IE J3 ECMA n/a |
Read-only | |
Returns a string version of the characters used to create the regular expression. The value does not include the forward slash delimiters that surround the expression. | |
Examplevar myREasString = myRE.source | |
Value String. |
compile() | NN 4 IE J3 ECMA n/a | ||
compile(pattern[, g | i | gi]) | |||
Compiles a regular expression pattern into a genuine regular expression object. This method is used primarily to recompile a regular expression whose pattern may change during the execution of a script. | |||
Returned Value regular expression object reference. | |||
Parameters
|
exec() | NN 4 IE J3 ECMA n/a | ||
exec(string) | |||
Performs a search through the string passed as a parameter for the current regular expression pattern. A typical sequence follows the format: var myRE = /somePattern/ var resultArray = myRE.exec("someString") Properties of both the static RegExp and regular expression (myRE in the example) objects are updated with information about the results of the search. In addition, the exec() method returns an array of data, much of it similar to RegExp object properties. The returned array includes the following properties: Zero-based index of starting character in the string that matches the pattern The original string being searched String of the characters matching the pattern Strings of the results of the parenthesized component matches You can stow away the results of the exec() method in a variable, whereas the RegExp property values change with the next regular expression operation. If the regular expression is set for global searching, a subsequent call to myRE.exec("someString") continues the search from the position of the previous match. If no match is found for a given call to exec(), it returns null. | |||
Returned Value An array of match information if successful; null if there is no match. | |||
Parameters
|
test() | NN 4 IE J3 ECMA n/a | ||
test(string) | |||
Returns true if there is a match of the regular expression anywhere in the string passed as a parameter; false if not. No additional information is available about the results of the search. This is the fastest way to find out if a pattern matches within a string. | |||
Returned Value Boolean. | |||
Parameters
|