PCRE.hpp

Go to the documentation of this file.

/*
 *
 * ---
 *
 *  Copyright (C) 2021 Anselm Schmidt (ans[ät]ohai.su)
 *
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation, either version 3 of the License, or
 *  (at your option) any later version in addition to the terms of any
 *  licences already herein identified.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program. If not, see <https://www.gnu.org/licenses/>.
 *
 * ---
 *
 * PCRE.hpp
 *
 * Wrapper for pointer to Perl-Compatible Regular Expression.
 *  Does NOT have ownership of the pointer, but takes care of its deletion!
 *
 *  Created on: Feb 7, 2019
 *      Author: ans
 */

#ifndef WRAPPER_PCRE_HPP_
#define WRAPPER_PCRE_HPP_

#include <pcre2.h>

namespace crawlservpp::Wrapper {

    /*
     * DECLARATION
     */


    class PCRE {
    public:

        PCRE() = default;

        explicit PCRE(pcre2_code * regExPtr) noexcept;
        virtual ~PCRE();


        [[nodiscard]] pcre2_code * get() noexcept;
        [[nodiscard]] const pcre2_code * getc() const noexcept;
        [[nodiscard]] bool valid() const noexcept;


        void set(pcre2_code * regExPtr);


        void clear() noexcept;



        PCRE(const PCRE& other);
        PCRE& operator=(const PCRE& other);
        PCRE(PCRE&& other) noexcept;
        PCRE& operator=(PCRE&& other) noexcept;


    private:
        // underlying pointer to regular expression
        pcre2_code * ptr{nullptr};
    };

    /*
     * IMPLEMENTATION
     */

    /*
     * CONSTRUCTION AND DESTRUCTION
     */


    inline PCRE::PCRE(pcre2_code * regExPtr) noexcept : ptr(regExPtr) {}

    inline PCRE::~PCRE() {
        this->clear();
    }

    /*
     * GETTERS
     */


    inline pcre2_code * PCRE::get() noexcept {
        return this->ptr;
    }


    inline const pcre2_code * PCRE::getc() const noexcept {
        return this->ptr;
    }


    inline bool PCRE::valid() const noexcept {
        return this->ptr != nullptr;
    }

    /*
     * SETTER
     */


    inline void PCRE::set(pcre2_code * regExPtr) {
        this->clear();

        this->ptr = regExPtr;
    }

    /*
     * CLEANUP
     */


    inline void PCRE::clear() noexcept {
        if(this->ptr != nullptr) {
            pcre2_code_free(this->ptr);

            this->ptr = nullptr;
        }
    }

    /*
     * COPY AND MOVE
     */


    inline PCRE::PCRE(const PCRE& other) {
        this->ptr = pcre2_code_copy_with_tables(other.getc());
    }


    inline PCRE& PCRE::operator=(const PCRE& other) {
        if(&other != this) {
            this->clear();

            this->ptr = pcre2_code_copy_with_tables(other.getc());
        }

        return *this;
    }


    inline PCRE::PCRE(PCRE&& other) noexcept : ptr(other.ptr) {
        other.ptr = nullptr;
    }


    inline PCRE& PCRE::operator=(PCRE&& other) noexcept {
        if(&other != this) {
            this->clear();

            this->ptr = other.ptr;

            other.ptr = nullptr;
        }

        return *this;
    }

} /* namespace crawlservpp::Wrapper */

#endif /* WRAPPER_PCRE_HPP_ */