/*
* Copyright (c) 2025 Aldrik Ramaekers <aldrik.ramaekers@gmail.com>
* 
* Permission to use, copy, modify, and/or distribute this software for any
* purpose with or without fee is hereby granted, provided that the above
* copyright notice and this permission notice appear in all copies.
* 
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
* ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
* ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
* OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/

#pragma once

#include "config.hpp"

/// @brief Namespace for string operations.
namespace strops {

    /// @brief Copy `src` into `dst`, with size check.
    /// @return Size copied.
    size_t  copy(char *dst, const char *src, size_t size);

    /// @brief Check if param `a` contains `b`.
    /// @return Pointer to the match inside `a`. or `NULL` when no match is found.
    char*   contains(char* a, char* b);

    /// @brief Check if `a` matches string `b`.
    /// @return `true` when strings match, else `false`.
    bool    equals(const char* a, const char* b);
    
    char*   tokenize(char* a, const char* find);

    s32     format_va(char* s, size_t n, const char* format, va_list args);
    s32     format(char* s, size_t n, const char* format, ...);

    void    replace(char *buf, size_t buf_size, const char *search, const char *replace);
    void    replace_int32(char *buf, size_t buf_size, const char *search, s32 number);
    void    replace_int64(char *buf, size_t buf_size, const char *search, s64 number);
    void    replace_float(char *buf, size_t buf_size, const char *search, float number, int decimals);

    bool    is_prefixed(const char *pre, const char *str);
    char*   get_filename(const char* path);

    char*   get_json_value(const char *json, const char *key, char *out, size_t out_size, int nth = 0);
    char*   prep_str_for_json(const char *input, size_t buffer_size);
    char*   unprep_str_from_json(char *input);

}