root/nntp/lexutils.hh

/*  This file is part of Alue, the multiprotocol Internet discussion daemon

    Copyright © 2009 Antti-Juhani Kaijanaho

    Alue 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.

    Alue 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 Alue.  If not, see <http://www.gnu.org/licenses/>.

 */

#ifndef GUARD_NNTP_LEXUTILS_HH
#define GUARD_NNTP_LEXUTILS_HH

#include "../db/group.hh"
#include "../util.hh"

#include <boost/tuple/tuple.hpp>
#include <string>

namespace nntp
{
        using util::strip_crlf;
        using util::parse_exception;
        using util::parse_nonnegative_integer;
        using util::split;
        using util::is_number;
        using util::is_digit;
        
        /** Returns true if s is a RFC 3977 keyword. */
        bool is_keyword(std::string s);

        /** Returns true if s is a RFC 3977 newsgroup name. */
        bool is_newsgroup_name(std::string s);

        /** Parses a RFC 3977 range: either nn (in which case (nn,nn)
         * is returned), nn- (in which case (nn,infinity) is
         * returned), or nn-mm (returning (nn,mm)).  Might throw
         * parse_exception. */
        boost::tuple<db::group::number, db::group::number>
        parse_range(std::string) throw (parse_exception);

        /** Returns true if s is empty or consists entirely of ws
         * characters. */
        inline bool is_ws_empty(std::string s, const char *ws = " \t\r\n") {
                return s.find_first_not_of(ws) == std::string::npos;
        }

        /** Returns true if c is an ASCII letter (note: locale has no
         * effect).  */
        inline bool is_alpha(char c) 
        {
                return  ('a' <= c && c <= 'z') ||
                        ('A' <= c && c <= 'Z');
        }

        /** Returns true if c is a RFC 3977 <wildmat-exact> character.  */
        inline bool is_wildmat_exact(char c) 
        {
                return (0x22 <= c && c <= 0x29) ||
                        c == 0x2b ||
                        (0x2d <= c && c <= 0x3e) ||
                        (0x40 <= c && c <= 0x5a) ||
                        (0x5e <= c && c <= 0x7e) ||
                        (unsigned char)(c) > 0x80;
        }

}
#endif /* GUARD_NNTP_LEXUTILS_HH */