Files
RestKit/Code/Search/RKSearchTokenizer.h
2012-08-28 17:34:58 -04:00

45 lines
1.4 KiB
Objective-C

//
// RKSearchTokenizer.h
// RestKit
//
// Created by Blake Watters on 7/30/12.
// Copyright (c) 2012 RestKit. All rights reserved.
//
#import <Foundation/Foundation.h>
/**
The RKSearchTokenizer class provides an interface for tokenizing input
text into a set of searchable words. Diacritics are removed and the input
text is tokenized case insensitively. A set of stop words can be optionally
trimmed from the result token set.
*/
@interface RKSearchTokenizer : NSObject
///-----------------------------------------------------------------------------
/// @name Configuring Tokenization
///-----------------------------------------------------------------------------
/**
The set of stop words that are to be removed from the token set.
Defaults to nil.
*/
@property (nonatomic, strong) NSSet *stopWords;
///-----------------------------------------------------------------------------
/// @name Tokenizing a String of Text
///-----------------------------------------------------------------------------
/**
Tokenizes the given string by folding it case and diacritic insensitively and then
splitting it apart using the the word unit delimiters for the current locale. If a set
of stop words has been provided, the resulting token set will have the stop words subtracted.
@param string A string of text you wish to tokenize.
@returns A set of searchable text tokens extracted from the given string.
*/
- (NSSet *)tokenize:(NSString *)string;
@end