NSDictionary RegexKit Additions Reference

Extends by categoryNSDictionary

FrameworkRegexKit.framework

RegexKit0.6.0 Release Notes

PCRE7.6

AvailabilityAvailable in Mac OS X v10.4 or later.

Declared in

RegexKit/NSDictionary.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

containsKeyMatchingRegex:

Returns a Boolean value that indicates whether any of the receivers keys are matched by aRegex.

- (BOOL)containsKeyMatchingRegex:(id)aRegex;

Returns a NSDictionary with a count of 0 if there are no matches.

- containsObjectMatchingRegex:

containsObjectMatchingRegex:

Returns a Boolean value that indicates whether any of the receivers objects are matched by aRegex.

- (BOOL)containsObjectMatchingRegex:(id)aRegex;

- containsKeyMatchingRegex:

dictionaryByMatchingKeysWithRegex:

Returns a new dictionary that contains the entries in the receiver whose keys are matched by aRegex.

- (NSDictionary *)dictionaryByMatchingKeysWithRegex:(id)aRegex;

dictionaryByMatchingObjectsWithRegex:

Returns a new dictionary that contains the entries in the receiver whose objects are matched by aRegex.

- (NSDictionary *)dictionaryByMatchingObjectsWithRegex:(id)aRegex;

Returns a NSDictionary with a count of 0 if there are no matches.

keysForObjectsMatchingRegex:

Returns an array containing the keys in the receiver whose object is matched by aRegex.

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

Returns a NSArray with a count of 0 if there are no matches.

keysMatchingRegex:

Returns an array of the receiver's keys that are matched by aRegex.

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

Returns a NSArray with a count of 0 if there are no matches.

objectsForKeysMatchingRegex:

Returns an array containing the objects in the receiver whose key is matched by aRegex.

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

Returns a NSArray with a count of 0 if there are no matches.

objectsMatchingRegex:

Returns an array containing the objects in the receiver that are matched by aRegex.

- (NSArray *)objectsMatchingRegex:(id)regexObject;

Returns a NSArray with a count of 0 if there are no matches.