@ladybugmem/icebug 0.1.0

package/vendor/include/tlx/string/split_view.hpp

@@ -0,0 +1,218 @@
+/*******************************************************************************
+ * tlx/string/split_view.hpp
+ *
+ * Split a std::string and call a functor with tlx::string_view for each part.
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2016-2024 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_SPLIT_VIEW_HEADER
+#define TLX_STRING_SPLIT_VIEW_HEADER
+
+#include <tlx/container/string_view.hpp>
+#include <string>
+#include <vector>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+//! \name Split and Join
+//! \{
+
+/******************************************************************************/
+// split_callback() with a Functor receiving string views
+
+/*!
+ * Split the given string at each separator character into distinct substrings,
+ * and call the given callback with a StringView for each substring. Multiple
+ * consecutive separators are considered individually and will result in empty
+ * split substrings.
+ *
+ * \param str       string to split
+ * \param sep       separator character
+ * \param callback  callback taking StringView of substring
+ * \param limit     maximum number of parts returned
+ */
+template <typename Functor>
+static inline void split_callback(
+    char sep, tlx::string_view str, Functor&& callback,
+    std::string::size_type limit = std::string::npos)
+{
+    if (limit == 0)
+    {
+        callback(StringView(str.begin(), str.end()));
+        return;
+    }
+
+    tlx::string_view::size_type count = 0;
+    tlx::string_view::const_iterator it = str.begin(), last = it;
+
+    for (; it != str.end(); ++it)
+    {
+        if (*it == sep)
+        {
+            if (count == limit)
+            {
+                callback(StringView(last, str.end()));
+                return;
+            }
+            callback(StringView(last, it));
+            ++count;
+            last = it + 1;
+        }
+    }
+    callback(StringView(last, it));
+}
+
+/******************************************************************************/
+// split_view() returning std::vector<tlx::string_view>
+
+/*!
+ * Split the given string at each separator character into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.
+ *
+ * \param sep    separator character
+ * \param str    string to split
+ * \param limit  maximum number of parts returned
+ * \return       vector containing each split substring
+ */
+std::vector<tlx::string_view> split_view(
+    char sep, tlx::string_view str,
+    tlx::string_view::size_type limit = tlx::string_view::npos);
+
+/*!
+ * Split the given string at each separator string into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.
+ *
+ * \param sep    separator string
+ * \param str    string to split
+ * \param limit  maximum number of parts returned
+ * \return       vector containing each split substring
+ */
+std::vector<tlx::string_view> split_view(
+    tlx::string_view sep, tlx::string_view str,
+    tlx::string_view::size_type limit = tlx::string_view::npos);
+
+/******************************************************************************/
+// split_view() returning std::vector<tlx::string_view> with minimum fields
+
+/*!
+ * Split the given string at each separator character into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.  Returns a vector of strings with at least
+ * min_fields and at most limit_fields, empty fields are added if needed.
+ *
+ * \param sep         separator string
+ * \param str         string to split
+ * \param min_fields  minimum number of parts returned
+ * \param limit       maximum number of parts returned
+ * \return            vector containing each split substring
+ */
+std::vector<tlx::string_view> split_view(char sep, tlx::string_view str,
+                                         tlx::string_view::size_type min_fields,
+                                         tlx::string_view::size_type limit);
+
+/*!
+ * Split the given string at each separator string into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.  Returns a vector of strings with at least
+ * min_fields and at most limit_fields, empty fields are added if needed.
+ *
+ * \param sep         separator string
+ * \param str         string to split
+ * \param min_fields  minimum number of parts returned
+ * \param limit       maximum number of parts returned
+ * \return            vector containing each split substring
+ */
+std::vector<tlx::string_view> split_view(tlx::string_view sep,
+                                         tlx::string_view str,
+                                         tlx::string_view::size_type min_fields,
+                                         tlx::string_view::size_type limit);
+
+/******************************************************************************/
+// split_view() into std::vector<tlx::string_view>
+
+/*!
+ * Split the given string at each separator character into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.
+ *
+ * \param into   destination std::vector
+ * \param sep    separator character
+ * \param str    string to split
+ * \param limit  maximum number of parts returned
+ * \return       vector containing each split substring
+ */
+std::vector<tlx::string_view>& split_view(
+    std::vector<tlx::string_view>* into, char sep, tlx::string_view str,
+    tlx::string_view::size_type limit = tlx::string_view::npos);
+
+/*!
+ * Split the given string at each separator string into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.
+ *
+ * \param into   destination std::vector
+ * \param sep    separator string
+ * \param str    string to split
+ * \param limit  maximum number of parts returned
+ * \return       vector containing each split substring
+ */
+std::vector<tlx::string_view>& split_view(
+    std::vector<tlx::string_view>* into, tlx::string_view sep,
+    tlx::string_view str,
+    tlx::string_view::size_type limit = tlx::string_view::npos);
+
+/******************************************************************************/
+// split_view() into std::vector<tlx::string_view> with minimum fields
+
+/*!
+ * Split the given string at each separator character into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.  Returns a vector of strings with at least
+ * min_fields and at most limit_fields, empty fields are added if needed.
+ *
+ * \param into        destination std::vector
+ * \param sep         separator character
+ * \param str         string to split
+ * \param min_fields  minimum number of parts returned
+ * \param limit       maximum number of parts returned
+ * \return            vector containing each split substring
+ */
+std::vector<tlx::string_view>& split_view(
+    std::vector<tlx::string_view>* into, char sep, tlx::string_view str,
+    tlx::string_view::size_type min_fields, tlx::string_view::size_type limit);
+
+/*!
+ * Split the given string at each separator string into distinct substrings.
+ * Multiple consecutive separators are considered individually and will result
+ * in empty split substrings.  Returns a vector of strings with at least
+ * min_fields and at most limit_fields, empty fields are added if needed.
+ *
+ * \param into        destination std::vector
+ * \param sep         separator string
+ * \param str         string to split
+ * \param min_fields  minimum number of parts returned
+ * \param limit       maximum number of parts returned
+ * \return            vector containing each split substring
+ */
+std::vector<tlx::string_view>& split_view(
+    std::vector<tlx::string_view>* into, tlx::string_view sep,
+    tlx::string_view str, tlx::string_view::size_type min_fields,
+    tlx::string_view::size_type limit);
+
+//! \}
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_SPLIT_VIEW_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/split_words.hpp

@@ -0,0 +1,53 @@
+/*******************************************************************************
+ * tlx/string/split_words.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2016-2024 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_SPLIT_WORDS_HEADER
+#define TLX_STRING_SPLIT_WORDS_HEADER
+
+#include <tlx/container/string_view.hpp>
+#include <string>
+#include <vector>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+/*!
+ * Split the given string by whitespaces into distinct words. Multiple
+ * consecutive whitespaces are considered as one split point. Whitespaces are
+ * space, tab, newline and carriage-return.
+ *
+ * \param str   string to split
+ * \param limit maximum number of parts returned
+ * \return      vector containing each split substring
+ */
+std::vector<std::string> split_words(
+    tlx::string_view str, std::string::size_type limit = std::string::npos);
+
+/*!
+ * Split the given string by whitespaces into distinct words. Multiple
+ * consecutive whitespaces are considered as one split point. Whitespaces are
+ * space, tab, newline and carriage-return.
+ *
+ * \param str   string to split
+ * \param limit maximum number of parts returned
+ * \return      vector containing each split substring
+ */
+std::vector<tlx::string_view> split_words_view(
+    tlx::string_view str, std::string::size_type limit = std::string::npos);
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_SPLIT_WORDS_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/ssprintf.hpp

@@ -0,0 +1,45 @@
+/*******************************************************************************
+ * tlx/string/ssprintf.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2007-2019 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_SSPRINTF_HEADER
+#define TLX_STRING_SSPRINTF_HEADER
+
+#include <tlx/define/attribute_format_printf.hpp>
+#include <cstddef>
+#include <string>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+/*!
+ * Helper for return the result of a sprintf() call inside a std::string.
+ *
+ * \param fmt printf format and additional parameters
+ */
+std::string ssprintf(const char* fmt, ...) TLX_ATTRIBUTE_FORMAT_PRINTF(1, 2);
+
+/*!
+ * Helper for return the result of a snprintf() call inside a std::string.
+ *
+ * \param max_size maximum length of output string, longer ones are truncated.
+ * \param fmt printf format and additional parameters
+ */
+std::string ssnprintf(size_t max_size, const char* fmt, ...)
+    TLX_ATTRIBUTE_FORMAT_PRINTF(2, 3);
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_SSPRINTF_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/ssprintf_generic.hpp

@@ -0,0 +1,95 @@
+/*******************************************************************************
+ * tlx/string/ssprintf_generic.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2007-2019 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_SSPRINTF_GENERIC_HEADER
+#define TLX_STRING_SSPRINTF_GENERIC_HEADER
+
+#include <tlx/define/attribute_format_printf.hpp>
+#include <cstdarg>
+#include <cstdio>
+#include <string>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+/*!
+ * Helper for return the result of a sprintf() call inside a string object.
+ *
+ * \param fmt printf format and additional parameters
+ */
+template <typename String = std::string>
+String ssprintf_generic(const char* fmt, ...) TLX_ATTRIBUTE_FORMAT_PRINTF(1, 2);
+
+template <typename String>
+String ssprintf_generic(const char* fmt, ...)
+{
+    String out;
+    out.resize(128);
+
+    va_list args;
+    va_start(args, fmt);
+
+    int size = std::vsnprintf(const_cast<char*>(out.data()), out.size() + 1,
+                              fmt, args);
+
+    if (size >= static_cast<int>(out.size()))
+    {
+        // error, grow buffer and try again.
+        out.resize(size);
+        size = std::vsnprintf(const_cast<char*>(out.data()), out.size() + 1,
+                              fmt, args);
+    }
+
+    out.resize(size);
+
+    va_end(args);
+
+    return out;
+}
+
+/*!
+ * Helper for return the result of a snprintf() call inside a string object.
+ *
+ * \param max_size maximum length of output string, longer ones are truncated.
+ * \param fmt printf format and additional parameters
+ */
+template <typename String = std::string>
+String ssnprintf_generic(size_t max_size, const char* fmt, ...)
+    TLX_ATTRIBUTE_FORMAT_PRINTF(2, 3);
+
+template <typename String>
+String ssnprintf_generic(size_t max_size, const char* fmt, ...)
+{
+    String out;
+    out.resize(max_size);
+
+    va_list args;
+    va_start(args, fmt);
+
+    int size = std::vsnprintf(const_cast<char*>(out.data()), out.size() + 1,
+                              fmt, args);
+
+    if (static_cast<size_t>(size) < max_size)
+        out.resize(static_cast<size_t>(size));
+
+    va_end(args);
+
+    return out;
+}
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_SSPRINTF_GENERIC_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/starts_with.hpp

@@ -0,0 +1,44 @@
+/*******************************************************************************
+ * tlx/string/starts_with.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2007-2024 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_STARTS_WITH_HEADER
+#define TLX_STRING_STARTS_WITH_HEADER
+
+#include <tlx/container/string_view.hpp>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+/******************************************************************************/
+
+/*!
+ * Checks if the given match string is located at the start of this string.
+ */
+bool starts_with(tlx::string_view str, tlx::string_view match);
+
+/******************************************************************************/
+
+/*!
+ * Checks if the given match string is located at the start of this
+ * string. Compares the characters case-insensitively.
+ */
+bool starts_with_icase(tlx::string_view str, tlx::string_view match);
+
+/******************************************************************************/
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_STARTS_WITH_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/to_lower.hpp

@@ -0,0 +1,47 @@
+/*******************************************************************************
+ * tlx/string/to_lower.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2007-2024 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_TO_LOWER_HEADER
+#define TLX_STRING_TO_LOWER_HEADER
+
+#include <tlx/container/string_view.hpp>
+#include <string>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+//! Transform the given character to lower case without any localization.
+char to_lower(char ch);
+
+/*!
+ * Transforms the given string to lowercase and returns a reference to it.
+ *
+ * \param str   string to process
+ * \return      reference to the modified string
+ */
+std::string& to_lower(std::string* str);
+
+/*!
+ * Returns a copy of the given string converted to lowercase.
+ *
+ * \param str   string to process
+ * \return      new string lowercased
+ */
+std::string to_lower(tlx::string_view str);
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_TO_LOWER_HEADER
+
+/******************************************************************************/

package/vendor/include/tlx/string/to_upper.hpp

@@ -0,0 +1,47 @@
+/*******************************************************************************
+ * tlx/string/to_upper.hpp
+ *
+ * Part of tlx - http://panthema.net/tlx
+ *
+ * Copyright (C) 2007-2024 Timo Bingmann <tb@panthema.net>
+ *
+ * All rights reserved. Published under the Boost Software License, Version 1.0
+ ******************************************************************************/
+
+#ifndef TLX_STRING_TO_UPPER_HEADER
+#define TLX_STRING_TO_UPPER_HEADER
+
+#include <tlx/container/string_view.hpp>
+#include <string>
+
+namespace tlx {
+
+//! \addtogroup tlx_string
+//! \{
+
+//! Transform the given character to upper case without any localization.
+char to_upper(char ch);
+
+/*!
+ * Transforms the given string to uppercase and returns a reference to it.
+ *
+ * \param str   string to process
+ * \return      reference to the modified string
+ */
+std::string& to_upper(std::string* str);
+
+/*!
+ * Returns a copy of the given string converted to uppercase.
+ *
+ * \param str   string to process
+ * \return      new string uppercased
+ */
+std::string to_upper(tlx::string_view str);
+
+//! \}
+
+} // namespace tlx
+
+#endif // !TLX_STRING_TO_UPPER_HEADER
+
+/******************************************************************************/