//
//  OCHamcrest - HCStringEndsWith.h
//  Copyright 2012 hamcrest.org. See LICENSE.txt
//
//  Created by: Jon Reid
//

#import <OCHamcrest/HCSubstringMatcher.h>


@interface HCStringEndsWith : HCSubstringMatcher

+ (id)stringEndsWith:(NSString *)aSubstring;

@end


OBJC_EXPORT id<HCMatcher> HC_endsWith(NSString *aSubstring);

/**
    endsWith(aString) -
    Matches if object is a string ending with a given string.

    @param aString  The string to search for. This value must not be @c nil.
    
    This matcher first checks whether the evaluated object is a string. If so, it checks if
    @a aString matches the ending characters of the evaluated object.
    
    Example:
    
    @par
    @ref endsWith(@"bar")
    
    will match "foobar".

    (In the event of a name clash, don't \#define @c HC_SHORTHAND and use the synonym
    @c HC_endsWith instead.)

    @ingroup text_matchers
 */
#ifdef HC_SHORTHAND
    #define endsWith HC_endsWith
#endif
