Package org.hamcrest.text

Class CharSequenceLength

java.lang.Object

org.hamcrest.BaseMatcher<CharSequence>

org.hamcrest.TypeSafeDiagnosingMatcher<CharSequence>

org.hamcrest.FeatureMatcher<CharSequence,Integer>

org.hamcrest.text.CharSequenceLength

All Implemented Interfaces:

Matcher<CharSequence>, SelfDescribing

public class CharSequenceLength
extends FeatureMatcher<CharSequence,Integer>

A Matcher that checks the length of a string.

Constructor Summary

Constructors

Constructor	Description
CharSequenceLength(Matcher<? super Integer> lengthMatcher)	Constructor, best called from hasLength(Matcher).

Method Summary

Modifier and Type	Method	Description
protected Integer	featureValueOf(CharSequence actual)	Implement this to extract the interesting feature.
static Matcher<CharSequence>	hasLength(int length)	Creates a matcher of CharSequence that matches when a char sequence has the given length For example:
static Matcher<CharSequence>	hasLength(Matcher<? super Integer> lengthMatcher)	Creates a matcher of CharSequence that matches when a char sequence has the given length For example:

Methods inherited from class org.hamcrest.FeatureMatcher

describeTo, matchesSafely

Methods inherited from class org.hamcrest.TypeSafeDiagnosingMatcher

describeMismatch, matches

Methods inherited from class org.hamcrest.BaseMatcher

_dont_implement_Matcher___instead_extend_BaseMatcher_, isNotNull, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

CharSequenceLength

public CharSequenceLength(Matcher<? super Integer> lengthMatcher)

Constructor, best called from hasLength(Matcher).

Parameters:

lengthMatcher - the expected length

See Also:

• hasLength(Matcher)

Method Details

featureValueOf

protected Integer featureValueOf(CharSequence actual)

Description copied from class: FeatureMatcher

Implement this to extract the interesting feature.

Specified by:

featureValueOf in class FeatureMatcher<CharSequence,Integer>

Parameters:

actual - the target object

Returns:

the feature to be matched

hasLength

public static Matcher<CharSequence> hasLength(int length)

Creates a matcher of CharSequence that matches when a char sequence has the given length For example:

 assertThat("text", hasLength(4))
 

Parameters:

length - the expected length of the string

Returns:

The matcher.

hasLength

public static Matcher<CharSequence> hasLength(Matcher<? super Integer> lengthMatcher)

Creates a matcher of CharSequence that matches when a char sequence has the given length For example:

 assertThat("text", hasLength(lessThan(4)))
 

Parameters:

lengthMatcher - the expected length of the string

Returns:

The matcher.