//
//  OCHamcrest - HCIsCollectionOnlyContaining.h
//  Copyright 2013 hamcrest.org. See LICENSE.txt
//
//  Created by: Jon Reid, http://qualitycoding.org/
//  Docs: http://hamcrest.github.com/OCHamcrest/
//  Source: https://github.com/hamcrest/OCHamcrest
//

#import <OCHamcrestIOS/HCBaseMatcher.h>


@interface HCIsCollectionOnlyContaining : HCBaseMatcher
{
    id<HCMatcher> matcher;
}

+ (instancetype)isCollectionOnlyContaining:(id<HCMatcher>)aMatcher;
- (instancetype)initWithMatcher:(id<HCMatcher>)aMatcher;

@end


OBJC_EXPORT id<HCMatcher> HC_onlyContains(id itemMatch, ...) NS_REQUIRES_NIL_TERMINATION;

/**
    onlyContains(firstMatcher, ...) -
    Matches if each element of collection satisfies any of the given matchers.
    
    @param firstMatcher,...  A comma-separated list of matchers ending with @c nil.
    
    This matcher iterates the evaluated collection, confirming whether each element satisfies any of
    the given matchers.
    
    Any argument that is not a matcher is implicitly wrapped in an @ref equalTo matcher to check for
    equality.

    Example:
    
    @par
    @ref onlyContains(startsWith(@"Jo"), nil)
    
    will match a collection [@"Jon", @"John", @"Johann"].
    
    (In the event of a name clash, don't \#define @c HC_SHORTHAND and use the synonym
    @c HC_onlyContains instead.)

    @ingroup collection_matchers
 */
#ifdef HC_SHORTHAND
    #define onlyContains HC_onlyContains
#endif