System::Text::RegularExpressions::Match Class Reference

Inherits System::Text::RegularExpressions::Group.

Public Member Functions

 Match (UStringPtr source, int index, int length)
 
GroupCollectionPtr get_Groups ()
 
MatchPtr NextMatch ()
 
virtual String Result (const String &replacement)
 
void SetMappedIndexes (const std::vector< int > &mapped_indexes)
 
void AddGroup (const GroupPtr &item)
 
void AddCapture (const CapturePtr item)
 
- Public Member Functions inherited from System::Text::RegularExpressions::Group
CaptureCollectionPtr get_Captures ()
 
bool get_Success ()
 
 Group (UStringPtr source, int index, int length)
 
 Group ()
 Constructor of empty group. More...
 
void AddCapture (const CapturePtr item)
 
- Public Member Functions inherited from System::Text::RegularExpressions::Capture
 Capture (UStringPtr source, int index, int length)
 
int get_Index () const
 
int get_Length () const
 
String get_Value () const
 
String ToString () ASPOSE_CONST override
 
- Public Member Functions inherited from System::Object
 Object ()
 Creates object. Initializes all internal data structures. More...
 
virtual ~Object ()
 Destroys object. Frees all internal data structures. More...
 
 Object (Object const &x)
 Copy constructor. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
Objectoperator= (Object const &x)
 Assignment operator. Doesn't copy anything, really, just initializes new object and enables copy constructing subclasses. More...
 
ObjectSharedRefAdded ()
 Increments shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int SharedRefRemovedSafe ()
 Decrements and returns shared reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
int RemovedSharedRefs (int count)
 Decreases shared reference count by specified value. More...
 
Detail::SmartPtrCounter * WeakRefAdded ()
 Increments weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
void WeakRefRemoved ()
 Decrements weak reference count. Shouldn't be called directly; instead, use smart pointers or ThisProtector. More...
 
Detail::SmartPtrCounter * GetCounter ()
 Gets reference counter data structure associated with the object. More...
 
int SharedCount () const
 Gets current value of shared refernce counter. More...
 
void Lock ()
 Implements C# lock() statement locking. Call directly or use LockContext sentry object. More...
 
void Unlock ()
 Implements C# lock() statement unlocking. Call directly or use LockContext sentry object. More...
 
virtual bool Equals (ptr obj)
 Compares objects using C# Object.Equals semantics. More...
 
virtual int GetHashCode () const
 Analog of C# Object.GetHashCode() method. Enables hashing of custom objects. More...
 
virtual ptr MemberwiseClone () const
 Analog of C# Object.MemberwiseClone() method. Enables cloning custom types. More...
 
virtual const TypeInfoGetType () const
 Gets actual type of object. Analog of C# System.Object.GetType() call. More...
 
virtual bool Is (const TypeInfo &targetType) const
 Check if object represents an instance of type described by targetType. Analog of C# 'is' operator. More...
 
virtual void SetTemplateWeakPtr (unsigned int argument)
 Set n'th template argument a weak pointer (rather than shared). Allows switching pointers in containers to weak mode. More...
 
template<>
bool Equals (float const &objA, float const &objB)
 
template<>
bool Equals (double const &objA, double const &objB)
 
template<>
bool ReferenceEquals (String const &str, std::nullptr_t)
 
template<>
bool ReferenceEquals (String const &str1, String const &str2)
 

Static Public Member Functions

static MatchPtr get_Empty ()
 
- Static Public Member Functions inherited from System::Object
static bool ReferenceEquals (ptr const &objA, ptr const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, T const &objB)
 Compares objects by reference. More...
 
template<typename T >
static std::enable_if<!IsSmartPtr< T >::value, bool >::type ReferenceEquals (T const &objA, std::nullptr_t)
 Reference-compares value type object with nullptr. More...
 
template<typename T1 , typename T2 >
static std::enable_if< IsSmartPtr< T1 >::value &&IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares reference type objects in C# style. More...
 
template<typename T1 , typename T2 >
static std::enable_if<!IsSmartPtr< T1 >::value &&!IsSmartPtr< T2 >::value, bool >::type Equals (T1 const &objA, T2 const &objB)
 Compares value type objects in C# style. More...
 
static const TypeInfoType ()
 Impleemnts C# typeof(System.Object) construct. More...
 

Additional Inherited Members

- Public Types inherited from System::Object
typedef SmartPtr< Objectptr
 Alias for smart pointer type. More...
 
typedef System::Details::SharedMembersType shared_members_type
 structure to keep list of shared pointers contained in object. More...
 
- Protected Attributes inherited from System::Text::RegularExpressions::Group
CaptureCollectionPtr captures
 Captures caught. More...
 
- Protected Attributes inherited from System::Text::RegularExpressions::Capture
int index
 Captured substring index. More...
 
int length
 Captured substring length. More...
 
UStringPtr source
 Original string. More...
 
- Static Protected Attributes inherited from System::Text::RegularExpressions::Group
static GroupPtr emptygroup
 

Detailed Description

Single match of regexp over string. Objects of this class should only be allocated using System::MakeObject() function. Never create instance of this type on stack or using operator new, as it will result in runtime errors and/or assertion faults. Always wrap this class into System::SmartPtr pointer and use this pointer to pass it to functions as argument.

Constructor & Destructor Documentation

◆ Match()

System::Text::RegularExpressions::Match::Match ( UStringPtr  source,
int  index,
int  length 
)

Constructor.

Parameters
sourceSource stirng.
indexMatch start index.
lengthMatch length.

Member Function Documentation

◆ AddCapture()

void System::Text::RegularExpressions::Match::AddCapture ( const CapturePtr  item)

Adds capture into match.

Parameters
itemItem to add.

◆ AddGroup()

void System::Text::RegularExpressions::Match::AddGroup ( const GroupPtr item)

Adds group into match.

Parameters
itemItem to add.

◆ get_Empty()

static MatchPtr System::Text::RegularExpressions::Match::get_Empty ( )
static

Empty match accessor.

Returns
Empty match singleton.

◆ get_Groups()

GroupCollectionPtr System::Text::RegularExpressions::Match::get_Groups ( )

Gets group list.

Returns
Groups owned by match.

◆ NextMatch()

MatchPtr System::Text::RegularExpressions::Match::NextMatch ( )

Iteration over matches.

Returns
Next match.

◆ Result()

virtual String System::Text::RegularExpressions::Match::Result ( const String replacement)
virtual

Formats string by replacing submatch references with their values.

Parameters
replacementFormat string with '$?'-styled substitutions.
Returns
Format string with substitutions done.

◆ SetMappedIndexes()

void System::Text::RegularExpressions::Match::SetMappedIndexes ( const std::vector< int > &  mapped_indexes)