libcruft-util/string.hpp

/*
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Copyright 2011-2016 Danny Robson <danny@nerdcruft.net>
 */

#ifndef __UTIL_STRING_HPP
#define __UTIL_STRING_HPP

#include "view.hpp"


namespace util {
    std::string to_utf8 (const wchar_t*);
    std::string to_utf8 (const std::wstring&);
}


bool
strbegins(const char *restrict str,
          const char *restrict prefix);


namespace util {
    template <typename Iterator>
    struct tokeniser {
    public:
        using value_type = typename std::iterator_traits<Iterator>::value_type;
        using range_type = view<Iterator>;

        tokeniser (Iterator first, Iterator last, value_type separator);

        template <typename ContainerT>
        tokeniser (ContainerT &container, typename ContainerT::value_type _separator):
            tokeniser (
                std::begin (container),
                std::end (container),
                _separator
            )
        { ; }

        struct iterator : public std::iterator<
            std::forward_iterator_tag,
            range_type,
            std::size_t
        > {
        public:
            iterator  operator++ (int);
            iterator& operator++ (void)&;

            range_type operator* (void) const;

            bool operator== (const iterator&) const;
            bool operator!= (const iterator&) const;

        private:
            iterator (range_type range, value_type separator);

            const value_type m_separator;
            range_type m_range;
            Iterator m_end;

            friend tokeniser;
        };

        iterator cbegin (void) const;
        iterator begin  (void) const;

        iterator cend (void) const;
        iterator end  (void) const;

    private:
        const range_type m_range;
        const value_type m_separator;
    };


    ///////////////////////////////////////////////////////////////////////////
    template <typename CharT, std::size_t LengthV>
    auto
    make_tokeniser (CharT (&data)[LengthV], CharT separator)
    {
        return tokeniser { std::begin (data), std::end (data), separator };
    }


    //-------------------------------------------------------------------------
    tokeniser<std::string::const_iterator>
    make_tokeniser (const std::string&, std::string::value_type);


    //-------------------------------------------------------------------------
    tokeniser<std::string::const_iterator>
    make_tokeniser (std::string&&, std::string::value_type) = delete;


    //-------------------------------------------------------------------------
    tokeniser<const char*>
    make_tokeniser (const char*, char);

}

#endif // __UTIL_STRING_HPP