Utils.h

Go to the documentation of this file.

/*
 * MIT License
 *
 * Copyright (c) 2025 nfx
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */

 
#pragma once
 
#include <cstdint>
#include <string>
#include <string_view>
 
namespace nfx::string
{
    //=====================================================================
    // String utilities
    //=====================================================================
 
    //----------------------------------------------
    // String validation
    //----------------------------------------------

    [[nodiscard]] inline constexpr bool hasExactLength( std::string_view str, std::size_t expectedLength ) noexcept;

    [[nodiscard]] inline constexpr bool isEmpty( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr bool isNullOrWhiteSpace( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr bool isAllDigits( std::string_view str ) noexcept;
 
    //----------------------------------------------
    // Character classification
    //----------------------------------------------

    [[nodiscard]] inline constexpr bool isWhitespace( char c ) noexcept;

    [[nodiscard]] inline constexpr bool isDigit( char c ) noexcept;

    [[nodiscard]] inline constexpr bool isAlpha( char c ) noexcept;

    [[nodiscard]] inline constexpr bool isAlphaNumeric( char c ) noexcept;
 
    //----------------------------------------------
    // String operations
    //----------------------------------------------

    [[nodiscard]] inline constexpr bool startsWith( std::string_view str, std::string_view prefix ) noexcept;

    [[nodiscard]] inline constexpr bool endsWith( std::string_view str, std::string_view suffix ) noexcept;

    [[nodiscard]] inline constexpr bool contains( std::string_view str, std::string_view substr ) noexcept;

    [[nodiscard]] inline constexpr bool equals( std::string_view lhs, std::string_view rhs ) noexcept;

    [[nodiscard]] inline bool iequals( std::string_view lhs, std::string_view rhs ) noexcept;

    [[nodiscard]] inline std::size_t count( std::string_view str, std::string_view substr ) noexcept;

    [[nodiscard]] inline std::size_t countOverlapping( std::string_view str, std::string_view substr ) noexcept;

    [[nodiscard]] inline constexpr std::size_t count( std::string_view str, char ch ) noexcept;

    [[nodiscard]] inline std::string replace( std::string_view str, std::string_view oldStr, std::string_view newStr );

    [[nodiscard]] inline std::string replaceAll( std::string_view str, std::string_view oldStr, std::string_view newStr );

    template <typename Container>
    [[nodiscard]] inline std::string join( const Container& elements, std::string_view delimiter );

    template <typename Iterator>
    [[nodiscard]] inline std::string join( Iterator begin, Iterator end, std::string_view delimiter );

    [[nodiscard]] inline std::string reverse( std::string_view str );

    [[nodiscard]] inline constexpr std::size_t indexOf( std::string_view str, std::string_view substr ) noexcept;

    [[nodiscard]] inline constexpr std::size_t lastIndexOf( std::string_view str, std::string_view substr ) noexcept;
 
    //----------------------------------------------
    // String formatting and padding
    //----------------------------------------------

    [[nodiscard]] inline std::string padLeft( std::string_view str, std::size_t width, char fillChar = ' ' );

    [[nodiscard]] inline std::string padRight( std::string_view str, std::size_t width, char fillChar = ' ' );

    [[nodiscard]] inline std::string center( std::string_view str, std::size_t width, char fillChar = ' ' );

    [[nodiscard]] inline std::string repeat( std::string_view str, std::size_t count );
 
    //----------------------------------------------
    // String trimming
    //----------------------------------------------

    [[nodiscard]] inline constexpr std::string_view trimStart( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr std::string_view trimEnd( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr std::string_view trim( std::string_view str ) noexcept;
 
    //----------------------------------------------
    // String case conversion
    //----------------------------------------------

    [[nodiscard]] inline std::string toLower( std::string_view str );

    [[nodiscard]] inline std::string toUpper( std::string_view str );
 
    //----------------------------------------------
    // Character case conversion
    //----------------------------------------------

    [[nodiscard]] inline constexpr char toLower( char c ) noexcept;

    [[nodiscard]] inline constexpr char toUpper( char c ) noexcept;
 
    //----------------------------------------------
    // String parsing
    //----------------------------------------------

    [[nodiscard]] inline bool tryParseBool( std::string_view str, bool& result ) noexcept;

    [[nodiscard]] inline bool tryParseInt( std::string_view str, int& result ) noexcept;

    [[nodiscard]] inline bool tryParseUInt( std::string_view str, std::uint32_t& result ) noexcept;

    [[nodiscard]] inline bool tryParseLong( std::string_view str, std::int64_t& result ) noexcept;

    [[nodiscard]] inline bool tryParseFloat( std::string_view str, float& result ) noexcept;

    [[nodiscard]] inline bool tryParseDouble( std::string_view str, double& result ) noexcept;
 
    //----------------------------------------------
    // Network and URI validation
    //----------------------------------------------
 
    //-----------------------------
    // URI character classification
    //-----------------------------

    [[nodiscard]] inline constexpr bool isURIReserved( char c ) noexcept;

    [[nodiscard]] inline constexpr bool isURIReserved( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr bool isURIUnreserved( char c ) noexcept;

    [[nodiscard]] inline constexpr bool isURIUnreserved( std::string_view str ) noexcept;
 
    //-----------------------------
    // IP address validation
    //-----------------------------

    [[nodiscard]] inline constexpr bool isIPv4Address( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr bool isIPv6Address( std::string_view str ) noexcept;
 
    //-----------------------------
    // Host validation
    //-----------------------------

    [[nodiscard]] inline constexpr bool isValidHostname( std::string_view str ) noexcept;

    [[nodiscard]] inline constexpr bool isDomainName( std::string_view str ) noexcept;
 
    //-----------------------------
    // Port validation
    //-----------------------------

    [[nodiscard]] inline constexpr bool isValidPort( std::string_view str ) noexcept;

    template <typename T, typename = std::enable_if_t<std::is_integral_v<T>>>
    [[nodiscard, deprecated( "Will be removed in v2.0.0. Use manual range check: (port >= 0 && port <= 65535)" )]]
    inline constexpr bool isValidPort( T port ) noexcept;
 
    //-----------------------------
    // Endpoint parsing
    //-----------------------------

    [[nodiscard]] inline bool tryParseEndpoint( std::string_view endpoint,
        std::string_view& host,
        uint16_t& port ) noexcept;
} // namespace nfx::string
 
#include "nfx/detail/string/Utils.inl"