summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorKrzysztof KosiƄski <krzysio@google.com>2024-04-12 20:18:22 (GMT)
committerCopybara-Service <copybara-worker@google.com>2024-04-12 20:19:21 (GMT)
commit5197b1a8e6a1ef9f214f4aa537b0be17cbf91946 (patch)
tree0b0ee9b4be902c9fe2143958afbe060f9c351cde
parentb1a777f31913f8a047f43b2a5f823e736e7f5082 (diff)
downloadgoogletest-5197b1a8e6a1ef9f214f4aa537b0be17cbf91946.zip
googletest-5197b1a8e6a1ef9f214f4aa537b0be17cbf91946.tar.gz
googletest-5197b1a8e6a1ef9f214f4aa537b0be17cbf91946.tar.bz2
Modify example in the primer to match Testing FAQ.
The CtorVsSetUp section of the FAQ says that constructors and destructors should be preferred over SetUp() and TearDown(), because they will automatically chain up to the fixture's base class, whereas for methods the user must remember to add the chaining manually. PiperOrigin-RevId: 624273474 Change-Id: Ida41aae193d417eaf996587c7ae1a0099a8cab32
-rw-r--r--docs/primer.md17
1 files changed, 8 insertions, 9 deletions
diff --git a/docs/primer.md b/docs/primer.md
index 0f90c03..61806be 100644
--- a/docs/primer.md
+++ b/docs/primer.md
@@ -273,14 +273,14 @@ First, define a fixture class. By convention, you should give it the name
```c++
class QueueTest : public testing::Test {
protected:
- void SetUp() override {
+ QueueTest() {
// q0_ remains empty
q1_.Enqueue(1);
q2_.Enqueue(2);
q2_.Enqueue(3);
}
- // void TearDown() override {}
+ // ~QueueTest() override = default;
Queue<int> q0_;
Queue<int> q1_;
@@ -288,8 +288,9 @@ class QueueTest : public testing::Test {
};
```
-In this case, `TearDown()` is not needed since we don't have to clean up after
-each test, other than what's already done by the destructor.
+In this case, we don't need to define a destructor or a `TearDown()` method,
+because the implicit destructor generated by the compiler will perform all of
+the necessary cleanup.
Now we'll write tests using `TEST_F()` and this fixture.
@@ -326,11 +327,9 @@ would lead to a segfault when `n` is `NULL`.
When these tests run, the following happens:
1. GoogleTest constructs a `QueueTest` object (let's call it `t1`).
-2. `t1.SetUp()` initializes `t1`.
-3. The first test (`IsEmptyInitially`) runs on `t1`.
-4. `t1.TearDown()` cleans up after the test finishes.
-5. `t1` is destructed.
-6. The above steps are repeated on another `QueueTest` object, this time
+2. The first test (`IsEmptyInitially`) runs on `t1`.
+3. `t1` is destructed.
+4. The above steps are repeated on another `QueueTest` object, this time
running the `DequeueWorks` test.
**Availability**: Linux, Windows, Mac.