xref: /aosp_15_r20/system/libvintf/include/vintf/Regex.h (revision 70a7ec852fcefd15a4fb57f8f183a8b1c3aacb08)
1*70a7ec85SAndroid Build Coastguard Worker /*
2*70a7ec85SAndroid Build Coastguard Worker  * Copyright (C) 2018 The Android Open Source Project
3*70a7ec85SAndroid Build Coastguard Worker  *
4*70a7ec85SAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*70a7ec85SAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*70a7ec85SAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*70a7ec85SAndroid Build Coastguard Worker  *
8*70a7ec85SAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*70a7ec85SAndroid Build Coastguard Worker  *
10*70a7ec85SAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*70a7ec85SAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*70a7ec85SAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*70a7ec85SAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*70a7ec85SAndroid Build Coastguard Worker  * limitations under the License.
15*70a7ec85SAndroid Build Coastguard Worker  */
16*70a7ec85SAndroid Build Coastguard Worker 
17*70a7ec85SAndroid Build Coastguard Worker #ifndef ANDROID_VINTF_REGEX_H_
18*70a7ec85SAndroid Build Coastguard Worker #define ANDROID_VINTF_REGEX_H_
19*70a7ec85SAndroid Build Coastguard Worker 
20*70a7ec85SAndroid Build Coastguard Worker #include <regex.h>
21*70a7ec85SAndroid Build Coastguard Worker #include <string>
22*70a7ec85SAndroid Build Coastguard Worker 
23*70a7ec85SAndroid Build Coastguard Worker namespace android {
24*70a7ec85SAndroid Build Coastguard Worker namespace vintf {
25*70a7ec85SAndroid Build Coastguard Worker namespace details {
26*70a7ec85SAndroid Build Coastguard Worker 
27*70a7ec85SAndroid Build Coastguard Worker // A wrapper class around regex.h. This is used instead of C++ <regex> library because
28*70a7ec85SAndroid Build Coastguard Worker // C++ regex library throws exceptions when an invalid regular expression is compiled.
29*70a7ec85SAndroid Build Coastguard Worker // Use Extended Regular Expression (ERE) syntax.
30*70a7ec85SAndroid Build Coastguard Worker class Regex {
31*70a7ec85SAndroid Build Coastguard Worker    public:
32*70a7ec85SAndroid Build Coastguard Worker     Regex() = default;
33*70a7ec85SAndroid Build Coastguard Worker     ~Regex();
34*70a7ec85SAndroid Build Coastguard Worker 
35*70a7ec85SAndroid Build Coastguard Worker     Regex& operator=(const Regex&) = delete;
36*70a7ec85SAndroid Build Coastguard Worker     Regex(const Regex&) = delete;
37*70a7ec85SAndroid Build Coastguard Worker 
38*70a7ec85SAndroid Build Coastguard Worker     __attribute__((warn_unused_result)) bool compile(const std::string& pattern);
39*70a7ec85SAndroid Build Coastguard Worker 
40*70a7ec85SAndroid Build Coastguard Worker     bool matches(const std::string& s) const;
41*70a7ec85SAndroid Build Coastguard Worker 
42*70a7ec85SAndroid Build Coastguard Worker     /**
43*70a7ec85SAndroid Build Coastguard Worker      * Return nullptr if not a valid regex pattern, else the Regex object.
44*70a7ec85SAndroid Build Coastguard Worker      */
45*70a7ec85SAndroid Build Coastguard Worker     static const Regex* Get(const std::string& pattern);
46*70a7ec85SAndroid Build Coastguard Worker 
47*70a7ec85SAndroid Build Coastguard Worker    private:
48*70a7ec85SAndroid Build Coastguard Worker     std::unique_ptr<regex_t> mImpl;
49*70a7ec85SAndroid Build Coastguard Worker 
50*70a7ec85SAndroid Build Coastguard Worker     void clear();
51*70a7ec85SAndroid Build Coastguard Worker };
52*70a7ec85SAndroid Build Coastguard Worker 
53*70a7ec85SAndroid Build Coastguard Worker }  // namespace details
54*70a7ec85SAndroid Build Coastguard Worker }  // namespace vintf
55*70a7ec85SAndroid Build Coastguard Worker }  // namespace android
56*70a7ec85SAndroid Build Coastguard Worker 
57*70a7ec85SAndroid Build Coastguard Worker #endif  // ANDROID_VINTF_REGEX_H_
58