libhext: C++ Library Documentation 1.0.13-b24695d
Loading...
Searching...
No Matches
BeginsWithTest.h
Go to the documentation of this file.
1// Copyright 2015, 2016 Thomas Trapp
2//
3// Licensed under the Apache License, Version 2.0 (the "License");
4// you may not use this file except in compliance with the License.
5// You may obtain a copy of the License at
6//
7// http://www.apache.org/licenses/LICENSE-2.0
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14
15#ifndef HEXT_BEGINS_WITH_TEST_H_INCLUDED
16#define HEXT_BEGINS_WITH_TEST_H_INCLUDED
17
18/// @file
19/// Declares hext::BeginsWithTest
20
21#include "hext/Cloneable.h"
22#include "hext/ValueTest.h"
23#include "hext/Visibility.h"
24
25#include <string>
26
27
28namespace hext {
29
30
31/// Tests whether a string begins with a given literal.
32///
33/// @par Example:
34/// ~~~~~~~~~~~~~
35/// BeginsWithTest begins("Start");
36///
37/// assert( begins.test("Startles your sleeping ears to hear"));
38/// assert(!begins.test("startles your sleeping ears to hear"));
39/// assert(!begins.test(""));
40/// ~~~~~~~~~~~~~
42 : public Cloneable<BeginsWithTest, ValueTest>
43{
44public:
45 /// Constructs a BeginsWithTest that succeeds for subjects that begin with
46 /// the given literal.
47 ///
48 /// @param literal: A string that a subject must begin with.
49 explicit BeginsWithTest(std::string literal) noexcept;
50
51 /// Return true if subject begins with the given literal.
52 ///
53 /// @param subject: The string that is to be tested.
54 bool test(const char * subject) const override;
55
56private:
57 /// The literal that must be matched.
58 std::string lit_;
59};
60
61
62} // namespace hext
63
64
65#endif // HEXT_BEGINS_WITH_TEST_H_INCLUDED
66
Defines template hext::Cloneable.
Declares hext::ValueTest.
Defines HEXT_PUBLIC and HEXT_PRIVATE.
#define HEXT_PUBLIC
Definition Visibility.h:26
Tests whether a string begins with a given literal.
BeginsWithTest(std::string literal) noexcept
Constructs a BeginsWithTest that succeeds for subjects that begin with the given literal.
bool test(const char *subject) const override
Return true if subject begins with the given literal.
Curiously recurring template pattern that extends a base class to provide a virtual method Cloneable:...
Definition Cloneable.h:37