common/stracc.h

Go to the documentation of this file.

//
//      aegis - project change supervisor
//      Copyright (C) 1998, 2001, 2004-2006, 2008 Peter Miller
//
//      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.
//
//      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
//      <http://www.gnu.org/licenses/>.
//

#ifndef COMMON_STRACC_H
#define COMMON_STRACC_H

#include <common/str.h>

class stracc_t
{
public:
    ~stracc_t();

    stracc_t();

    stracc_t(const stracc_t &);

    stracc_t &operator=(const stracc_t &);

    string_ty *mkstr() const;

    void
    push_back(char c)
    {
        //
        // The stracc::push_back(char) method shows up in the profiles
        // as occupying 10% of the time it takes to parse the database
        // files.  By making it an inline, things go measurably faster.
        //
        if (length < maximum)
            buffer[length++] = c;
        else
            overflow(c);
    }

    void push_back(const char *data, size_t len);

    void push_back(const char *data);

    void push_back(const stracc_t &data);

    char back() { return buffer[length - 1]; }

    void clear() { length = 0; }

    size_t size() const { return length; }

    bool empty() const { return (length == 0); }

    void pop_back() { if (length) --length; }

    const char *get_data() const { return buffer; }

    char operator[](size_t n) { return buffer[n]; }

    size_t count_nul_characters() const;

private:
    void overflow(char c);

    size_t length;

    size_t maximum;

    char *buffer;
};

inline DEPRECATED void
stracc_constructor(stracc_t *p)
{
    p->clear();
}

inline DEPRECATED void
stracc_destructor(stracc_t *p)
{
    p->clear();
}

inline DEPRECATED void
stracc_open(stracc_t *p)
{
    p->clear();
}

inline DEPRECATED string_ty *
stracc_close(const stracc_t *p)
{
    return p->mkstr();
}

inline DEPRECATED void
stracc_char(stracc_t *p, char c)
{
    p->push_back(c);
}

inline DEPRECATED void
stracc_chars(stracc_t *p, const char *data, size_t len)
{
    p->push_back(data, len);
}


#endif // COMMON_STRACC_H