diff options
author | Gennadiy Civil <misterg@google.com> | 2019-07-15 19:58:44 (GMT) |
---|---|---|
committer | Gennadiy Civil <misterg@google.com> | 2019-07-15 19:58:44 (GMT) |
commit | 073a2da4032d95744345ef21cb3256cc551033ad (patch) | |
tree | 4b42af16184f1c4ccfb724a36f8953646eb851be /googlemock/docs/cook_book.md | |
parent | 01573aa0e85197d6ee4c6666135ba9d0102f42df (diff) | |
download | googletest-073a2da4032d95744345ef21cb3256cc551033ad.zip googletest-073a2da4032d95744345ef21cb3256cc551033ad.tar.gz googletest-073a2da4032d95744345ef21cb3256cc551033ad.tar.bz2 |
Preparation for including docs in round-trip with OSS
Diffstat (limited to 'googlemock/docs/cook_book.md')
-rw-r--r-- | googlemock/docs/cook_book.md | 36 |
1 files changed, 4 insertions, 32 deletions
diff --git a/googlemock/docs/cook_book.md b/googlemock/docs/cook_book.md index 285e770..ef2818a 100644 --- a/googlemock/docs/cook_book.md +++ b/googlemock/docs/cook_book.md @@ -1138,29 +1138,6 @@ Note that the predicate function / functor doesn't have to return `bool`. It works as long as the return value can be used as the condition in in statement `if (condition) ...`. -#### Using Callbacks as Matchers - -Callbacks are widely used in `google3`. Conceptually, a `ResultCallback1<bool, -T>` is just a predicate on argument of type `T`. Naturally, we sometimes would -want to use such a callback as a matcher. - -gMock gives you two function templates in namespace `testing` to turn callbacks -into matchers. - -The first is `Truly(callback)`. It matches `argument` iff -`callback->Run(argument)` returns `true`. - -The second is `AddressSatisfies(callback)`, which matches `argument` whenever -`callback->Run(&argument)` returns `true`. - -The callbacks used in `Truly()` and `AddressSatisfies()` must be permanent (e.g. -those returned by `NewPermanentCallback()`), or you'll get a run-time error. The -matcher takes ownership of the callback, so you don't need to worry about -deleting it. - -For examples, see -google3/testing/base/internal/gmock_utils/callback-matchers_test.cc. - #### Matching Arguments that Are Not Copyable When you do an `EXPECT_CALL(mock_obj, Foo(bar))`, gMock saves away a copy of @@ -2167,16 +2144,11 @@ Note that both `ON_CALL` and `EXPECT_CALL` have the same "later statements take precedence" rule, but they don't interact. That is, `EXPECT_CALL`s have their own precedence order distinct from the `ON_CALL` precedence order. -#### Using Functions/Methods/Functors/Lambdas/Callbacks as Actions {#FunctionsAsActions} - -If the built-in actions don't suit you, you can easily use an existing callable -(function, `std::function`, method, functor, lambda, or `google3` permanent -callback) as an action. Note that `Callback` or member function must be wrapped -with `Invoke()`, whereas lambdas and functors will work by themselves. +#### Using Functions/Methods/Functors/Lambdas as Actions {#FunctionsAsActions} -```cpp -using ::testing::_; -using ::testing::Invoke; +If the built-in actions don't suit you, you can use an existing callable +(function, `std::function`, method, functor, lambda as an action. ```cpp +using ::testing::_; using ::testing::Invoke; class MockFoo : public Foo { public: |