3party/googletest
0
0
Fork 0
mirror of https://github.com/google/googletest.git synced 2024-12-27 10:11:03 +08:00
Code Issues Projects Releases Wiki Activity

Googletest export

Browse Source 
Don't use fully qualified ::std types in code examples.

Having a nested user-defined 'std' namespace anywhere in a program is a minefield and shouldn't be either explicitly supported or implicitly condoned.

PiperOrigin-RevId: 285790182
This commit is contained in:
krzysio 2019-12-16 12:41:00 -05:00 committed by CJ Johnson
parent 5b162a79d4
commit 0a0c826629
1 changed files with 17 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
googlemock/docs/cook_book.md
View File

@ -1024,9 +1024,8 @@ using ::testing::Lt;
says that the first argument of `InRange()` must not be 0, and must be less than says that the first argument of `InRange()` must not be 0, and must be less than
the second argument. the second argument.
The expression inside `With()` must be a matcher of type The expression inside `With()` must be a matcher of type `Matcher<std::tuple<A1,
`Matcher< ::std::tuple<A1, ..., An> >`, where `A1`, ..., `An` are the types of ..., An>>`, where `A1`, ..., `An` are the types of the function arguments.
the function arguments.
You can also write `AllArgs(m)` instead of `m` inside `.With()`. The two forms You can also write `AllArgs(m)` instead of `m` inside `.With()`. The two forms
are equivalent, but `.With(AllArgs(Lt()))` is more readable than `.With(Lt())`. are equivalent, but `.With(AllArgs(Lt()))` is more readable than `.With(Lt())`.
@ -1054,8 +1053,8 @@ complete list.
Note that if you want to pass the arguments to a predicate of your own (e.g. Note that if you want to pass the arguments to a predicate of your own (e.g.
`.With(Args<0, 1>(Truly(&MyPredicate)))`), that predicate MUST be written to `.With(Args<0, 1>(Truly(&MyPredicate)))`), that predicate MUST be written to
take a `::std::tuple` as its argument; gMock will pass the `n` selected take a `std::tuple` as its argument; gMock will pass the `n` selected arguments
arguments as *one* single tuple to the predicate. as *one* single tuple to the predicate.
### Using Matchers as Predicates ### Using Matchers as Predicates
@ -1331,11 +1330,11 @@ class BarPlusBazEqMatcher : public MatcherInterface<const Foo&> {
return (foo.bar() + foo.baz()) == expected_sum_; return (foo.bar() + foo.baz()) == expected_sum_;
} }
void DescribeTo(::std::ostream* os) const override { void DescribeTo(std::ostream* os) const override {
*os << "bar() + baz() equals " << expected_sum_; *os << "bar() + baz() equals " << expected_sum_;
} }
void DescribeNegationTo(::std::ostream* os) const override { void DescribeNegationTo(std::ostream* os) const override {
*os << "bar() + baz() does not equal " << expected_sum_; *os << "bar() + baz() does not equal " << expected_sum_;
} }
private: private:
@ -3565,7 +3564,7 @@ class MatchResultListener {
MatchResultListener& operator<<(const T& x); MatchResultListener& operator<<(const T& x);
// Returns the underlying ostream. // Returns the underlying ostream.
::std::ostream* stream(); std::ostream* stream();
}; };
template <typename T> template <typename T>
@ -3578,10 +3577,10 @@ class MatcherInterface {
virtual bool MatchAndExplain(T x, MatchResultListener* listener) const = 0; virtual bool MatchAndExplain(T x, MatchResultListener* listener) const = 0;
// Describes this matcher to an ostream. // Describes this matcher to an ostream.
virtual void DescribeTo(::std::ostream* os) const = 0; virtual void DescribeTo(std::ostream* os) const = 0;
// Describes the negation of this matcher to an ostream. // Describes the negation of this matcher to an ostream.
virtual void DescribeNegationTo(::std::ostream* os) const; virtual void DescribeNegationTo(std::ostream* os) const;
}; };
``` ```
@ -3609,11 +3608,11 @@ class DivisibleBy7Matcher : public MatcherInterface<int> {
return (n % 7) == 0; return (n % 7) == 0;
} }
void DescribeTo(::std::ostream* os) const override { void DescribeTo(std::ostream* os) const override {
*os << "is divisible by 7"; *os << "is divisible by 7";
} }
void DescribeNegationTo(::std::ostream* os) const override { void DescribeNegationTo(std::ostream* os) const override {
*os << "is not divisible by 7"; *os << "is not divisible by 7";
} }
}; };
@ -3995,7 +3994,7 @@ ACTION_TEMPLATE(DuplicateArg,
// Note the comma between int and k: // Note the comma between int and k:
HAS_2_TEMPLATE_PARAMS(int, k, typename, T), HAS_2_TEMPLATE_PARAMS(int, k, typename, T),
AND_1_VALUE_PARAMS(output)) { AND_1_VALUE_PARAMS(output)) {
*output = T(::std::get<k>(args)); *output = T(std::get<k>(args));
} }
``` ```
@ -4087,7 +4086,7 @@ class ActionInterface {
// //
// For example, if F is int(bool, const string&), then Result would // For example, if F is int(bool, const string&), then Result would
// be int, and ArgumentTuple would be ::std::tuple<bool, const string&>. // be int, and ArgumentTuple would be std::tuple<bool, const string&>.
virtual Result Perform(const ArgumentTuple& args) = 0; virtual Result Perform(const ArgumentTuple& args) = 0;
}; };
``` ```
@ -4102,8 +4101,8 @@ typedef int IncrementMethod(int*);
class IncrementArgumentAction : public ActionInterface<IncrementMethod> { class IncrementArgumentAction : public ActionInterface<IncrementMethod> {
public: public:
int Perform(const ::std::tuple<int*>& args) override { int Perform(const std::tuple<int*>& args) override {
int* p = ::std::get<0>(args); // Grabs the first argument. int* p = std::get<0>(args); // Grabs the first argument.
return *p++; return *p++;
} }
}; };
@ -4148,8 +4147,8 @@ class ReturnSecondArgumentAction {
public: public:
template <typename Result, typename ArgumentTuple> template <typename Result, typename ArgumentTuple>
Result Perform(const ArgumentTuple& args) const { Result Perform(const ArgumentTuple& args) const {
// To get the i-th (0-based) argument, use ::std::get(args). // To get the i-th (0-based) argument, use std::get(args).
return ::std::get<1>(args); return std::get<1>(args);
} }
}; };
``` ```