string_utilities.hpp

Go to the documentation of this file.

// *****************************************************************************
//
// © Copyright 2020, Septentrio NV/SA.
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//    1. Redistributions of source code must retain the above copyright
//       notice, this list of conditions and the following disclaimer.
//    2. Redistributions in binary form must reproduce the above copyright
//       notice, this list of conditions and the following disclaimer in the
//       documentation and/or other materials provided with the distribution.
//    3. Neither the name of the copyright holder nor the names of its
//       contributors may be used to endorse or promote products derived
//       from this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
// POSSIBILITY OF SUCH DAMAGE.
//
// *****************************************************************************
 
#pragma once
 
// C and C++ library includes
#include <cstdint>
#include <locale> // Merely for "isdigit()" function, also available in <cctype.h> C header..
#include <string>
 
namespace string_utilities {
    [[nodiscard]] bool toDouble(const std::string& string, double& value);
 
    [[nodiscard]] bool toFloat(const std::string& string, float& value);
 
    [[nodiscard]] bool toInt32(const std::string& string, int32_t& value, int32_t base = 10);
 
    [[nodiscard]] bool toUInt32(const std::string& string, uint32_t& value, int32_t base = 10);
 
    [[nodiscard]] int8_t toInt8(const std::string& string, int8_t& value, int32_t base = 10);
 
    [[nodiscard]] uint8_t toUInt8(const std::string& string, uint8_t& value, int32_t base = 10);
 
    [[nodiscard]] std::string trimDecimalPlaces(double num);
 
    [[nodiscard]] bool containsSpace(const std::string str);
} // namespace string_utilities