VBScript Tutorials - Herong's Tutorial Examples - Version 5.20, by Dr. Herong Yang

"MatchCollection" and "SubMatches" Collection Objects

This section describes two collection objects, MatchCollection and SubMatches. All collection objects share the Count property and the Item(i) method.

We are mentioned that MatchCollection and SubMatches objects are collection objects. All collection objects share same properties and methods:

  • oCollection.Count - An integer property representing the number of items in this collection.
  • oCollection.Item(i) - A method returning the item at position i in this collection. The "Item(i)" method is defined as the default method of a collection object. So you can call this method without the method name. For example, oCollection(0) is equivalent to oCollection.Item(0), referring to the first item in this collection.

An collection object can also be used like an array in a "For Each" statement:

   For Each e In oCollection
      ... = ... e ... ' e Represents the current item
   End For

If you apply the above properties and methods to a MatchCollection object, oMatches, returned from the oRegExp.Execute(string) method, you should understand the following interesting examples:

  • oMatches.Count - Number of Match objects.
  • oMatches.Item(0) - The first Match object.
  • oMatches(0) - The first Match object.
  • oMatches(1).SubMatches - The SubMatches collection object of the second Match object.
  • oMatches(1).SubMatches.Count - The number of sub matche strings of the second Match object.
  • oMatches(1).SubMatches.Item(1) - The second sub match string of the second Match object.
  • oMatches(1).SubMatches(1) - The second sub match string of the second Match object.

Table of Contents

 About This Book

 Introduction of VBScript - Visual Basic Scripting Edition

 Variant Data Type, Subtypes, and Literals

 Arithmetic Operations

 Numeric Comparison Operations and Logical Operations

 String Operations - Concatenation and Comparison

 Variable Declaration and Assignment Statement

 Expression and Order of Operation Precedence

 Statement Syntax and Statement Types

 Array Data Type and Related Statements

 Array References and Array Assignment Statements

 Conditional Statements - "If ... Then" and "Select Case"

 Loop Statements - "For", "While", and "Do"

 "Function" and "Sub" Procedures

 Built-in Functions

 Inspecting Variables Received in Procedures

 Error Handling Flag and the "Err" Object

Regular Expression Pattern Match and Replacement

 "RegExp" Class and Object for Regular Expression Support

"MatchCollection" and "SubMatches" Collection Objects

 "Set oRegExp = New RegExp" - Creating RegExp Objects

 Example of Regular Expression Match and Replacement

 scrrun.dll - Scripting Runtime DLL Library

 Creating Your Own Classes

 IE Web Browser Supporting VBScript

 IIS ASP Server Supporting VBScript

 WSH (Windows Script Host)

 References

 Printable Copy - PDF Version

"MatchCollection" and "SubMatches" Collection Objects - Updated in 2015, by Dr. Herong Yang