[Strings] Refactor Strings Usage (#2305)

* Initial commit checkpoint * More functions converted * Commify * More functions * Fin * Sort declarations * Split functions between files * Bots * Update strings.h * Split * Revert find replaces * Repository template * Money * Misc function * Update CMakeLists.txt * Saylink * Update strings.cpp * Swap Strings::Saylink for Saylink::Create since saylink is coupled to zone database * API casings
2026-05-19 13:28:25 +00:00 · 2022-07-14 02:10:52 -05:00
parent 44c85a0dd7
commit dfd8f84cac
573 changed files with 5197 additions and 5137 deletions
@@ -0,0 +1,216 @@
+/*
+ * Copyright 2013 Facebook, Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+#ifndef _STRINGUTIL_H_
+#define _STRINGUTIL_H_
+
+#include <sstream>
+#include <string.h>
+#include <vector>
+#include <cstdarg>
+#include <tuple>
+
+#ifndef _WIN32
+// this doesn't appear to affect linux-based systems..need feedback for _WIN64
+#include <fmt/format.h>
+
+#endif
+
+#ifdef _WINDOWS
+#include <ctype.h>
+#include <functional>
+#include <algorithm>
+#endif
+
+#include "types.h"
+
+class Strings {
+public:
+	static bool Contains(std::vector<std::string> container, std::string element);
+	static bool IsNumber(const std::string &s);
+	static const std::string ToLower(std::string s);
+	static const std::string ToUpper(std::string s);
+	static const std::string UcFirst(std::string s);
+	static std::string &LTrim(std::string &str, const std::string &chars = "\t\n\v\f\r ");
+	static std::string &RTrim(std::string &str, const std::string &chars = "\t\n\v\f\r ");
+	static std::string &Trim(std::string &str, const std::string &chars = "\t\n\v\f\r ");
+	static std::string Commify(const std::string &number);
+	static std::string ConvertToDigit(int n, std::string suffix);
+	static std::string Escape(const std::string &s);
+	static std::string GetBetween(const std::string &s, std::string start_delim, std::string stop_delim);
+	static std::string Implode(std::string glue, std::vector<std::string> src);
+	static std::string Join(const std::vector<std::string> &ar, const std::string &delim);
+	static std::string MillisecondsToTime(int duration);
+	static std::string Money(uint32 platinum, uint32 gold = 0, uint32 silver = 0, uint32 copper = 0);
+	static std::string NumberToWords(unsigned long long int n);
+	static std::string Repeat(std::string s, int n);
+	static std::string Replace(std::string subject, const std::string &search, const std::string &replace);
+	static std::string SecondsToTime(int duration, bool is_milliseconds = false);
+	static std::string::size_type SearchDelim(const std::string &haystack, const std::string &needle, const char deliminator = ',');
+	static std::vector<std::string> Split(const std::string &s, const char delim = ',');
+	static std::vector<std::string> Split(std::string s, std::string delimiter);
+	static std::vector<std::string> Wrap(std::vector<std::string> &src, std::string character);
+	static void FindReplace(std::string &string_subject, const std::string &search_string, const std::string &replace_string);
+
+	template<typename T>
+	static std::string
+	ImplodePair(const std::string &glue, const std::pair<char, char> &encapsulation, const std::vector<T> &src)
+	{
+		if (src.empty()) {
+			return {};
+		}
+		std::ostringstream oss;
+		for (const T &src_iter: src) {
+			oss << encapsulation.first << src_iter << encapsulation.second << glue;
+		}
+		std::string output(oss.str());
+		output.resize(output.size() - glue.size());
+		return output;
+	}
+};
+
+const std::string StringFormat(const char *format, ...);
+const std::string vStringFormat(const char *format, va_list args);
+
+// For converstion of numerics into English
+// Used for grid nodes, as NPC names remove numerals.
+// But general purpose
+
+const std::string NUM_TO_ENGLISH_X[] = {
+	"", "One ", "Two ", "Three ", "Four ",
+	"Five ", "Six ", "Seven ", "Eight ", "Nine ", "Ten ", "Eleven ",
+	"Twelve ", "Thirteen ", "Fourteen ", "Fifteen ",
+	"Sixteen ", "Seventeen ", "Eighteen ", "Nineteen "
+};
+
+const std::string NUM_TO_ENGLISH_Y[] = {
+	"", "", "Twenty ", "Thirty ", "Forty ",
+	"Fifty ", "Sixty ", "Seventy ", "Eighty ", "Ninety "
+};
+
+// _WIN32 builds require that #include<fmt/format.h> be included in whatever code file the invocation is made from (no header files)
+template<typename T1, typename T2>
+std::vector<std::string> join_pair(
+	const std::string &glue,
+	const std::pair<char, char> &encapsulation,
+	const std::vector<std::pair<T1, T2>> &src
+)
+{
+	if (src.empty()) {
+		return {};
+	}
+
+	std::vector<std::string> output;
+
+	for (const std::pair<T1, T2> &src_iter: src) {
+		output.push_back(
+
+			fmt::format(
+				"{}{}{}{}{}{}{}",
+				encapsulation.first,
+				src_iter.first,
+				encapsulation.second,
+				glue,
+				encapsulation.first,
+				src_iter.second,
+				encapsulation.second
+			)
+		);
+	}
+
+	return output;
+}
+
+// _WIN32 builds require that #include<fmt/format.h> be included in whatever code file the invocation is made from (no header files)
+template<typename T1, typename T2, typename T3, typename T4>
+std::vector<std::string> join_tuple(
+	const std::string &glue,
+	const std::pair<char, char> &encapsulation,
+	const std::vector<std::tuple<T1, T2, T3, T4>> &src
+)
+{
+	if (src.empty()) {
+		return {};
+	}
+
+	std::vector<std::string> output;
+
+	for (const std::tuple<T1, T2, T3, T4> &src_iter: src) {
+
+		output.push_back(
+
+			fmt::format(
+				"{}{}{}{}{}{}{}{}{}{}{}{}{}{}{}",
+				encapsulation.first,
+				std::get<0>(src_iter),
+				encapsulation.second,
+				glue,
+				encapsulation.first,
+				std::get<1>(src_iter),
+				encapsulation.second,
+				glue,
+				encapsulation.first,
+				std::get<2>(src_iter),
+				encapsulation.second,
+				glue,
+				encapsulation.first,
+				std::get<3>(src_iter),
+				encapsulation.second
+			)
+		);
+	}
+
+	return output;
+}
+
+// misc functions
+std::string SanitizeWorldServerName(std::string server_long_name);
+std::vector<std::string> GetBadWords();
+void ParseAccountString(const std::string &s, std::string &account, std::string &loginserver);
+
+// old c string functions
+
+bool atobool(const char *iBool);
+bool isAlphaNumeric(const char *text);
+bool strn0cpyt(char *dest, const char *source, uint32 size);
+char *CleanMobName(const char *in, char *out);
+char *RemoveApostrophes(const char *s);
+char *strn0cpy(char *dest, const char *source, uint32 size);
+const char *ConvertArray(int64 input, char *returnchar);
+const char *ConvertArrayF(float input, char *returnchar);
+const char *MakeLowerString(const char *source);
+uint32 hextoi(const char *num);
+uint64 hextoi64(const char *num);
+void MakeLowerString(const char *source, char *target);
+void RemoveApostrophes(std::string &s);
+std::string FormatName(const std::string &char_name);
+bool IsAllowedWorldServerCharacterList(char c);
+void SanitizeWorldServerName(char *name);
+
+template<typename InputIterator, typename OutputIterator>
+auto CleanMobName(InputIterator first, InputIterator last, OutputIterator result)
+{
+	for (; first != last; ++first) {
+		if (*first == '_') {
+			*result = ' ';
+		}
+		else if (isalpha(*first) || *first == '`') {
+			*result = *first;
+		}
+	}
+	return result;
+}
+
+#endif