Class

org.scalatest.words

BeWord

Related Doc: package words

Permalink

final class BeWord extends AnyRef

This class is part of the ScalaTest matchers DSL. Please see the documentation for Matchers or MustMatchers for an overview of the matchers DSL.

Class BeWord contains an apply method that takes a Symbol, which uses reflection to find and access a Boolean property and determine if it is true. If the symbol passed is 'empty, for example, the apply method will use reflection to look for a public Java field named "empty", a public method named "empty", or a public method named "isEmpty". If a field, it must be of type Boolean. If a method, it must take no parameters and return Boolean. If multiple candidates are found, the apply method will select based on the following algorithm:

FieldMethod"is" MethodResult
   Throws TestFailedException, because no candidates found
  isEmpty()Invokes isEmpty()
 empty() Invokes empty()
 empty()isEmpty()Invokes empty() (this can occur when BeanProperty annotation is used)
empty  Accesses field empty
empty isEmpty()Invokes isEmpty()
emptyempty() Invokes empty()
emptyempty()isEmpty()Invokes empty() (this can occur when BeanProperty annotation is used)

Source
BeWord.scala
Linear Supertypes
AnyRef, Any
Ordering
  1. Alphabetic
  2. By inheritance
Inherited
  1. BeWord
  2. AnyRef
  3. Any
  1. Hide All
  2. Show all
Visibility
  1. Public
  2. All

Instance Constructors

  1. new BeWord()

    Permalink

Value Members

  1. final def !=(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  3. def <[T](right: T)(implicit arg0: Ordering[T]): Matcher[T]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be < (7)
                     ^
    

    Note that the less than operator will be invoked on be in this expression, not on a result of passing be to should, as with most other operators in the matchers DSL, because the less than operator has a higher precedence than should. Thus in the above case the first expression evaluated will be be < (7), which results in a matcher that is passed to should.

    This method also enables the following syntax:

    result should not (be < (7))
                          ^
    

  4. def <=[T](right: T)(implicit arg0: Ordering[T]): Matcher[T]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be <= (7)
                     ^
    

    Note that the less than or equal to operator will be invoked on be in this expression, not on a result of passing be to should, as with most other operators in the matchers DSL, because the less than or equal to operator has a higher precedence than should. Thus in the above case the first expression evaluated will be be <= (7), which results in a matcher that is passed to should.

    This method also enables the following syntax:

    result should not (be <= (7))
                          ^
    

  5. final def ==(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  6. def >[T](right: T)(implicit arg0: Ordering[T]): Matcher[T]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be > (7)
                     ^
    

    Note that the greater than operator will be invoked on be in this expression, not on a result of passing be to should, as with most other operators in the matchers DSL, because the greater than operator has a higher precedence than should. Thus in the above case the first expression evaluated will be be > (7), which results in a matcher that is passed to should.

    This method also enables the following syntax:

    result should not (be > (7))
                          ^
    

  7. def >=[T](right: T)(implicit arg0: Ordering[T]): Matcher[T]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be >= (7)
                     ^
    

    Note that the greater than or equal to operator will be invoked on be in this expression, not on a result of passing be to should, as with most other operators in the matchers DSL, because the greater than or equal to operator has a higher precedence than should. Thus in the above case the first expression evaluated will be be >= (7), which results in a matcher that is passed to should.

    This method also enables the following syntax:

    result should not (be >= (7))
                          ^
    

  8. def a[S](aMatcher: AMatcher[S]): Matcher[S]

    Permalink

    This method enables the following syntax, where negativeNumber is, for example, of type AMatcher:

    This method enables the following syntax, where negativeNumber is, for example, of type AMatcher:

    8 should not { be a (negativeNumber) }
                      ^
    

  9. def a[S <: AnyRef](bePropertyMatcher: BePropertyMatcher[S]): Matcher[S]

    Permalink

    This method enables the following syntax, where fileMock is, for example, of type File and file refers to a BePropertyMatcher[File]:

    This method enables the following syntax, where fileMock is, for example, of type File and file refers to a BePropertyMatcher[File]:

    fileMock should not { be a (file) }
                             ^
    

  10. def a(right: Symbol): Matcher[AnyRef]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    fileMock should not { be a ('file) }
                             ^
    

  11. def an[S](anMatcher: AnMatcher[S]): Matcher[S]

    Permalink

    This method enables the following syntax, where oddNumber is, for example, of type AnMatcher:

    This method enables the following syntax, where oddNumber is, for example, of type AnMatcher:

    8 should not { be an (oddNumber) }
                      ^
    

  12. def an[S <: AnyRef](bePropertyMatcher: BePropertyMatcher[S]): Matcher[S]

    Permalink

    This method enables the following syntax, where keyEvent is, for example, of type KeyEvent and actionKey refers to a BePropertyMatcher[KeyEvent]:

    This method enables the following syntax, where keyEvent is, for example, of type KeyEvent and actionKey refers to a BePropertyMatcher[KeyEvent]:

    keyEvent should not { be an (actionKey) }
                             ^
    

  13. def an(right: Symbol): Matcher[AnyRef]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    animal should not { be an ('elephant) }
                           ^
    

  14. def apply(defined: DefinedWord): MatcherFactory1[Any, Definition]

    Permalink

    This method enables syntax such as the following:

    This method enables syntax such as the following:

    array should be (defined)
                    ^
    

  15. def apply(empty: EmptyWord): MatcherFactory1[Any, Emptiness]

    Permalink

    This method enables syntax such as the following:

    This method enables syntax such as the following:

    array should be (empty)
                    ^
    

  16. def apply(writable: WritableWord): MatcherFactory1[Any, Writability]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    file should be (writable)
                    ^
    

  17. def apply(readable: ReadableWord): MatcherFactory1[Any, Readability]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    file should be (readable)
                   ^
    

  18. macro def apply(anType: ResultOfAnTypeInvocation[_]): Matcher[Any]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    result should be (an [Book])
                  ^
    

  19. macro def apply(aType: ResultOfATypeInvocation[_]): Matcher[Any]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    result should be (a [Book])
                  ^
    

  20. def apply[A, U <: PartialFunction[A, _]](resultOfDefinedAt: ResultOfDefinedAt[A]): Matcher[U]

    Permalink

    This method enables the following syntax, where fraction refers to a PartialFunction:

    This method enables the following syntax, where fraction refers to a PartialFunction:

    fraction should (be (definedAt (6)) and be (definedAt (8)))
                     ^
    

  21. def apply(right: SortedWord): MatcherFactory1[Any, Sortable]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    List(1, 2, 3) should be (sorted)
                             ^
    

  22. def apply(right: Any): Matcher[Any]

    Permalink

    This method enables be to be used for equality comparison.

    This method enables be to be used for equality comparison. Here are some examples:

    result should be (None)
                     ^
    result should be (Some(1))
                     ^
    result should be (true)
                     ^
    result should be (false)
                     ^
    sum should be (19)
                  ^
    

  23. def apply[T](bePropertyMatcher: BePropertyMatcher[T]): Matcher[T]

    Permalink

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    This method enables the following syntax, where open refers to a BePropertyMatcher:

    door should be (open)
                   ^
    

  24. def apply[T](right: BeMatcher[T]): Matcher[T]

    Permalink

    This method enables the following syntax, where num is, for example, of type Int and odd refers to a BeMatcher[Int]:

    This method enables the following syntax, where num is, for example, of type Int and odd refers to a BeMatcher[Int]:

    num should be (odd)
                  ^
    

  25. def apply(right: Symbol): Matcher[AnyRef]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    set should be ('empty)
                  ^
    

  26. def apply(o: Null): Matcher[AnyRef]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be (null)
                     ^
    

  27. def apply(right: Boolean): Matcher[Boolean]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be (true)
                     ^
    

  28. def apply[U](spread: Spread[U]): Matcher[U]

    Permalink

    This method enables the following syntax for the "primitive" numeric types:

    This method enables the following syntax for the "primitive" numeric types:

    sevenDotOh should be (7.1 +- 0.2)
                         ^
    

  29. final def asInstanceOf[T0]: T0

    Permalink
    Definition Classes
    Any
  30. def clone(): AnyRef

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  31. def definedAt[A, U <: PartialFunction[A, _]](right: A): Matcher[U]

    Permalink

    This method enables the following syntax, where fraction refers to a PartialFunction:

    This method enables the following syntax, where fraction refers to a PartialFunction:

    fraction should (be definedAt (6) and be definedAt (8))
                        ^
    

  32. final def eq(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  33. def equals(arg0: Any): Boolean

    Permalink
    Definition Classes
    AnyRef → Any
  34. def finalize(): Unit

    Permalink
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  35. final def getClass(): Class[_]

    Permalink
    Definition Classes
    AnyRef → Any
  36. def hashCode(): Int

    Permalink
    Definition Classes
    AnyRef → Any
  37. final def isInstanceOf[T0]: Boolean

    Permalink
    Definition Classes
    Any
  38. final def ne(arg0: AnyRef): Boolean

    Permalink
    Definition Classes
    AnyRef
  39. final def notify(): Unit

    Permalink
    Definition Classes
    AnyRef
  40. final def notifyAll(): Unit

    Permalink
    Definition Classes
    AnyRef
  41. final def synchronized[T0](arg0: ⇒ T0): T0

    Permalink
    Definition Classes
    AnyRef
  42. def theSameInstanceAs(right: AnyRef): Matcher[AnyRef]

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    result should be theSameInstancreAs (anotherObject)
                     ^
    

  43. def thrownBy(code: ⇒ Unit): ResultOfBeThrownBy

    Permalink

    This method enables the following syntax:

    This method enables the following syntax:

    a[Exception] should (be thrownBy { "hi".charAt(-1) })
                            ^
    

  44. def toString(): String

    Permalink

    Overrides toString to return "be"

    Overrides toString to return "be"

    Definition Classes
    BeWord → AnyRef → Any
  45. final def wait(): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  46. final def wait(arg0: Long, arg1: Int): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  47. final def wait(arg0: Long): Unit

    Permalink
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )

Deprecated Value Members

  1. def ===(right: Any): Matcher[Any]

    Permalink

    The deprecation period for the "be ===" syntax has expired, and the syntax will now throw NotAllowedException. Please use should equal, should ===, shouldEqual, should be, or shouldBe instead.

    The deprecation period for the "be ===" syntax has expired, and the syntax will now throw NotAllowedException. Please use should equal, should ===, shouldEqual, should be, or shouldBe instead.

    Note: usually syntax will be removed after its deprecation period. This was left in because otherwise the syntax could in some cases still compile, but silently wouldn't work.

    Annotations
    @deprecated
    Deprecated

    The deprecation period for the be === syntax has expired. Please use should equal, should ===, shouldEqual, should be, or shouldBe instead.

Inherited from AnyRef

Inherited from Any

Ungrouped