The release version of RegexKitLite 3.0 is now available. You can download it at: http://downloads.sourceforge.net/regexkit/RegexKitLite-3.0.tar.bz2 Documentation is available at: http://regexkit.sourceforge.net/RegexKitLite/index.html XCode 3 integrated documentation is also available: feed:// regexkit.sourceforge.net/RegexKitLiteDocSets.atom
Release notes for 3.0 can be viewed at: http://regexkit.sourceforge.net/RegexKitLite/index.html#ReleaseInformation_30 Highlights of what's new in 3.0 (copy and pasted from a previous message): As always, bug fixes. :) New methods added- - (NSArray *)arrayOfCaptureComponentsMatchedByRegex:(NSString *)regex; - (NSArray *)captureComponentsMatchedByRegex:(NSString *)regex; - (NSInteger)captureCount; - (NSArray *)componentsMatchedByRegex:(NSString *)regex; - (void)flushCachedRegexData; - (BOOL)isRegexValid; Probably the most interesting are the methods that return a NSArray. componentsMatchedByRegex: essentially replaces the functionality that was previously available via RKLMatchEnumerator. For example, to extract every match by a regular expression from a string, you can use: NSArray *matchesArray [searchString componentsMatchedByRegex:@ "\\b(https?)://([a-zA-Z0-9\\-.]+)((?:/[a-zA-Z0-9\\-._?,'+\\&%$=~*!():@\\\\]*)+)"]; This creates a NSArray of all the http url's in a string. Since the result is a NSArray, you can use ObjC2's for...in feature to iterate over all the matches. The method arrayOfCaptureComponentsMatchedByRegex: also returns all the matches in a string, but each match result is a NSArray which contains the strings matched by all the capture groups in a regular expression. Building on the previous example: searchString = @"Visit http://www.cocoadev.com/index.pl?RecentChanges for more information"; for(NSArray *captureArray in [searchString arrayOfCaptureComponentsMatchedByRegex:@"\\b(https?)://([a-zA-Z0-9\\-.]+)((?:/[a-zA-Z0-9\\-._?,'+\\&%$=~*!():@\\\\]*)+)"]) { // Process each result.. // captureArray == [NSArray arrayWithObjects:@" http://www.cocoadev.com/index.pl?RecentChanges";, @"http", @"www.cocoadev.com", @"/index.pl?RecentChanges", NULL]; } The string at a given captureArray index corresponds to the regular expression capture group, with 0 being the entire match. Also included is support for RegexKitLite DTrace provider probe points. The two probe points, compiledRegexCache and utf16ConversionCache, are meant to provide visibility in to the effectiveness of the caches. While some regex performance problems can be due to the nature of the regex being executed, these probe points can give you insight in to whether or not part of the performance problem is due to thrashing of the caches. If that's the case, you can probably restructure the problem in a way to minimize the thrashing, and then test the changes. These probe points can give you hard data to make informed choices. Another feature added is the pre-processor tunable 'RKL_APPEND_TO_ICU_FUNCTIONS'. This is particular useful if you do not want to link to the Apple provided /usr/lib/libicucore.dylib. Custom build ICU libraries will typically have the version appended to the ICU function, such as "_3_6". This allows you to easily target such a library. Building your own, custom ICU library to link against is not for the feint of heart, though. RegexKitLite doesn't include instructions for doing so, but this should make it easy to use RegexKitLite with such a library if you need to do so. A custom build of ICU can easily weigh in at 10 (ten) megabytes. _______________________________________________ Cocoa-dev mailing list (Cocoa-dev@lists.apple.com) Please do not post admin requests or moderator comments to the list. Contact the moderators at cocoa-dev-admins(at)lists.apple.com Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com This email sent to arch...@mail-archive.com
