reader_util.h

Go to the documentation of this file.

/*
 * This file is part of liblcf. Copyright (c) 2020 liblcf authors.
 * https://github.com/EasyRPG/liblcf - https://easyrpg.org
 *
 * liblcf is Free/Libre Open Source Software, released under the MIT License.
 * For the full copyright and license information, please view the COPYING
 * file that was distributed with this source code.
 */
 
#ifndef LCF_READER_UTIL_H
#define LCF_READER_UTIL_H
 
#include <string>
#include <vector>
 
namespace ReaderUtil {
    std::string CodepageToEncoding(int codepage);
 
    std::string DetectEncoding(std::istream& filestream);
 
    std::string DetectEncoding(const std::string& data);
 
    std::vector<std::string> DetectEncodings(std::istream& filestream);
 
    std::vector<std::string> DetectEncodings(const std::string& data);
 
    std::string GetEncoding(const std::string& ini_file);
 
    std::string GetEncoding(std::istream& filestream);
 
    std::string GetLocaleEncoding();
 
    std::string Recode(const std::string& str_to_encode, const std::string& source_encoding);
 
    std::string Recode(const std::string& str_to_encode,
                       const std::string& src_enc,
                       const std::string& dst_enc);
 
    std::string Normalize(const std::string &str);
 
 
    template<typename T>
    T* GetElement(std::vector<T>& vec, int one_based_index) {
        if (one_based_index < 1) {
            return nullptr;
        }
 
        // index is nonnegative, safe to cast
        if (static_cast<typename std::vector<T>::size_type>(one_based_index) > vec.size()) {
            return nullptr;
        }
 
        return &vec[one_based_index - 1];
    }
 
    template<typename T>
    const T* GetElement(const std::vector<T>& vec, int one_based_index) {
        if (one_based_index < 1) {
            return nullptr;
        }
 
        // index is nonnegative, safe to cast
        if (static_cast<typename std::vector<T>::size_type>(one_based_index) > vec.size()) {
            return nullptr;
        }
 
        return &vec[one_based_index - 1];
    }
}
 
#endif