stdstringutils.hpp

Go to the documentation of this file.

/******************************************************************************
* Copyright (c) ATTX INC 2025. All Rights Reserved.
*
* This software and associated documentation (the "Software") are the 
* proprietary and confidential information of ATTX INC. The Software is 
* furnished under a license agreement between ATTX and the user organization 
* and may be used or copied only in accordance with the terms of the agreement.
* Refer to 'license/attx_license.adoc' for standard license terms.
*
* EXPORT CONTROL NOTICE: THIS SOFTWARE MAY INCLUDE CONTENT CONTROLLED UNDER THE
* INTERNATIONAL TRAFFIC IN ARMS REGULATIONS (ITAR) OR THE EXPORT ADMINISTRATION 
* REGULATIONS (EAR99). No part of the Software may be used, reproduced, or 
* transmitted in any form or by any means, for any purpose, without the express 
* written permission of ATTX INC.
******************************************************************************/
#ifndef UTILS_STDSTRINGUTILS_HPP
#define UTILS_STDSTRINGUTILS_HPP
 
#include <string>
#include <array>
#include <vector>
 
#include "core/clockwerkerrors.h"
 
namespace warptwin {
    std::string toUpper(const std::string &input);

    std::string toLower(const std::string &input);

    bool caseInsensitiveEqual(const std::string &in_a, const std::string &in_b);

    std::string stringReplace(const std::string &source, const std::string &orig_str, const std::string &new_str);

    std::string strip(const std::string& input);

    int splitString(const std::string& text, const std::string& delimiter,
                    std::vector<std::string>& tokens);

    bool isValidNumber(const std::string& s);

    template <typename T, long unsigned int N>
    int setArrayFromString(const std::string &s, std::array<T, N>& retval) {
        // Verify our string is formatted correctly
        if(s.size() < 2 || s.front() != '[' || s.back() != ']') {
            return ERROR_CANNOT_CONVERT_STRING;
        }
 
        // Extract the indices of our commas
        std::vector<unsigned int> comma_indices;
        unsigned int start_idx = 0;
        std::size_t found = s.find(",", start_idx);
        while(found != std::string::npos) {
            comma_indices.push_back(found);
            start_idx = found + 1;
            found = s.find(",", start_idx);
        }
        comma_indices.push_back(s.size() - 1);
 
        // Verify our array and raise error if no match
        if(comma_indices.size() != N) {
            return ERROR_DIMENSIONS;
        }
 
        // Now set the values of our array
        unsigned int idx = 0;
        std::string num_str;
        for(unsigned int i = 0; i < comma_indices.size(); i++) {
            // Pull the string for our number
            num_str = s.substr(idx+1, comma_indices[i] - idx - 1);
 
            // Extract our number and push it onto our array
            if(isValidNumber(num_str)) {
                retval[i] = (T)stod(num_str);
            } else {
                return ERROR_CANNOT_CONVERT_STRING;
            }
 
            idx = comma_indices[i];
        }
 
        return NO_ERROR;
    }

    template <typename T>
    int setVectorFromString(const std::string &s, std::vector<T>& retval) {
        // Verify our string is formatted correctly
        if(s.size() < 2 || s.front() != '[' || s.back() != ']') {
            return ERROR_CANNOT_CONVERT_STRING;
        }
 
        // Extract the indices of our commas
        std::vector<unsigned int> comma_indices;
        unsigned int start_idx = 0;
        std::size_t found = s.find(",", start_idx);
        while(found != std::string::npos) {
            comma_indices.push_back(found);
            start_idx = found + 1;
            found = s.find(",", start_idx);
        }
        comma_indices.push_back(s.size() - 1);
 
        // Now set the values of our array
        unsigned int idx = 0;
        std::string num_str;
        for(unsigned int i = 0; i < comma_indices.size(); i++) {
            // Pull the string for our number
            num_str = s.substr(idx+1, comma_indices[i] - idx - 1);
 
            // Extract our number and push it onto our array
            if(isValidNumber(num_str)) {
                if(retval.size() > i) {
                    retval[i] = (T)stod(num_str);
                } else {
                    retval.push_back((T)stod(num_str));
                }
            } else {
                return ERROR_CANNOT_CONVERT_STRING;
            }
 
            idx = comma_indices[i];
        }
 
        return NO_ERROR;
    }
}
 
#endif