NSArray RegexKit Additions Reference

Extends by categoryNSArray

FrameworkRegexKit.framework

RegexKit0.6.0 Release Notes

PCRE7.6

AvailabilityAvailable in Mac OS X v10.4 or later.

Declared in

RegexKit/NSArray.h

Companion guides

Specifying a Regular Expression

When specifying a regular expression, the regular expression can be either a RKRegex object or a NSString containing the text of a regular expression. When specified as a NSString, as determined by sending isKindOfClass:, the receiver will convert the string to a RKRegex object via regexWithRegexString:options:.

Important:

The method will raise NSInvalidArgumentException if the regular expression is nil. If passed as a NSString, the method will raise RKRegexSyntaxErrorException if the regular expression is not valid.

Determining if an Object Matches a Regular Expression

Objects are sent isMatchedByRegex: to determine whether or not they are matched by the specified regular expression.

Tasks

Instance Methods

arrayByMatchingObjectsWithRegex:

Returns a new array that contains all the objects in the receiver matching aRegex.

- (NSArray *)arrayByMatchingObjectsWithRegex:(id)aRegex;

arrayByMatchingObjectsWithRegex:inRange:

Returns a new array that contains all the objects in the receiver matching aRegex within the specified range.

- (NSArray *)arrayByMatchingObjectsWithRegex:(id)aRegex inRange:(const NSRange)range;

- addObjectsFromArray:matchingRegex:

containsObjectMatchingRegex:

Returns a Boolean value that indicates whether an object matching aRegex is present in the receiver.

- (BOOL)containsObjectMatchingRegex:(id)aRegex;

YES if an object that is matched by aRegex is present in the receiver, otherwise NO.

containsObjectMatchingRegex:inRange:

Returns a Boolean value that indicates whether an object in the specified range matching aRegex is present in the receiver.

- (BOOL)containsObjectMatchingRegex:(id)aRegex inRange:(const NSRange)range;

YES if an object that is matched by aRegex is present in the receiver, otherwise NO.

- indexOfObjectMatchingRegex:inRange:

countOfObjectsMatchingRegex:

Returns the number of objects matching aRegex in the receiver.

- (RKUInteger)countOfObjectsMatchingRegex:(id)aRegex;

- countOfObjectsMatchingRegex:inRange:

countOfObjectsMatchingRegex:inRange:

Returns the number of objects matching aRegex in the receiver within the specified range.

- (RKUInteger)countOfObjectsMatchingRegex:(id)aRegex inRange:(const NSRange)range;

indexOfObjectMatchingRegex:

Searches the receiver for an object that matches aRegex and returns the lowest index whose corresponding array value is equal to the matched object.

- (RKUInteger)indexOfObjectMatchingRegex:(id)aRegex;

If none of the objects in the receiver are matched by aRegex, indexOfObjectMatchingRegex: returns NSNotFound.

- indexOfObjectMatchingRegex:inRange:

indexOfObjectMatchingRegex:inRange:

Searches the specified range within the receiver for an object that matches aRegex and returns the lowest index whose corresponding array value is equal to the matched object.

- (RKUInteger)indexOfObjectMatchingRegex:(id)aRegex inRange:(const NSRange)range;

If none of the objects in the specified range are matched by aRegex, indexOfObjectMatchingRegex:inRange: returns NSNotFound.

- indexOfObjectMatchingRegex:

indexSetOfObjectsMatchingRegex:

Searches the receiver for objects that are matched by aRegex and returns a NSIndexSet containing the matching indexes.

- (NSIndexSet *)indexSetOfObjectsMatchingRegex:(id)aRegex;

- indexSetOfObjectsMatchingRegex:inRange:

indexSetOfObjectsMatchingRegex:inRange:

Searches the specified range within the receiver for objects that are matched by aRegex and returns a NSIndexSet containing the matching indexes.

- (NSIndexSet *)indexSetOfObjectsMatchingRegex:(id)aRegex inRange:(const NSRange)range;

- indexSetOfObjectsMatchingRegex: