Mark [[eraseable]] most of the common functions in the lib directory. Since many...

[xonotic/xonotic-data.pk3dir.git] / qcsrc / lib / string.qh

diff --git a/qcsrc/lib/string.qh b/qcsrc/lib/string.qh
index 9f0c5ca13bcaea342e6e27537931dc7b076aeff4..33aacebabdbd8d8eee975006f6c9c1bf4dab1c5d 100644 (file)
--- a/qcsrc/lib/string.qh
+++ b/qcsrc/lib/string.qh
@@ -27,6 +27,7 @@
        }
 #endif
 
+[[eraseable]]
 string seconds_tostring(float sec)
 {
        float minutes = floor(sec / 60);
@@ -34,6 +35,7 @@ string seconds_tostring(float sec)
        return sprintf("%d:%02d", minutes, sec);
 }
 
+[[eraseable]]
 string format_time(float seconds)
 {
        seconds = floor(seconds + 0.5);
@@ -47,6 +49,7 @@ string format_time(float seconds)
        else return sprintf(_("%02d:%02d:%02d"), hours, minutes, seconds);
 }
 
+[[eraseable]]
 string mmsss(float tenths)
 {
        tenths = floor(tenths + 0.5);
@@ -56,6 +59,7 @@ string mmsss(float tenths)
        return strcat(ftos(minutes), ":", substring(s, 1, 2), ".", substring(s, 3, 1));
 }
 
+[[eraseable]]
 string mmssss(float hundredths)
 {
        hundredths = floor(hundredths + 0.5);
@@ -67,6 +71,7 @@ string mmssss(float hundredths)
 
 int ColorTranslateMode;
 
+[[eraseable]]
 string ColorTranslateRGB(string s)
 {
        return (ColorTranslateMode & 1) ? strdecolorize(s) : s;
@@ -111,6 +116,7 @@ string CCR(string input)
 
 #define startsWith(haystack, needle) (strstrofs(haystack, needle, 0) == 0)
 
+[[eraseable]]
 bool startsWithNocase(string haystack, string needle)
 {
        return strcasecmp(substring(haystack, 0, strlen(needle)), needle) == 0;
@@ -120,6 +126,7 @@ noref string _endsWith_suffix;
 #define endsWith(this, suffix) (_endsWith_suffix = suffix, substring(this, -strlen(_endsWith_suffix), -1) == _endsWith_suffix)
 
 /** unzone the string, and return it as tempstring. Safe to be called on string_null */
+[[eraseable]]
 string fstrunzone(string s)
 {
        if (!s) return s;
@@ -129,6 +136,7 @@ string fstrunzone(string s)
 }
 
 /** returns first word */
+[[eraseable]]
 string car(string s)
 {
        int o = strstrofs(s, " ", 0);
@@ -137,6 +145,7 @@ string car(string s)
 }
 
 /** returns all but first word */
+[[eraseable]]
 string cdr(string s)
 {
        int o = strstrofs(s, " ", 0);
@@ -144,6 +153,7 @@ string cdr(string s)
        return substring(s, o + 1, strlen(s) - (o + 1));
 }
 
+[[eraseable]]
 string cons(string a, string b)
 {
        if (a == "") return b;
@@ -151,11 +161,13 @@ string cons(string a, string b)
        return strcat(a, " ", b);
 }
 
+[[eraseable]]
 string substring_range(string s, float b, float e)
 {
        return substring(s, b, e - b);
 }
 
+[[eraseable]]
 string swapwords(string str, float i, float j)
 {
        float n;
@@ -177,10 +189,13 @@ string swapwords(string str, float i, float j)
 }
 
 string _shufflewords_str;
+[[eraseable]]
 void _shufflewords_swapfunc(float i, float j, entity pass)
 {
        _shufflewords_str = swapwords(_shufflewords_str, i, j);
 }
+
+[[eraseable]]
 string shufflewords(string str)
 {
        _shufflewords_str = str;
@@ -191,6 +206,7 @@ string shufflewords(string str)
        return str;
 }
 
+[[eraseable]]
 string unescape(string in)
 {
        in = strzone(in);  // but it doesn't seem to be necessary in my tests at least
@@ -215,6 +231,7 @@ string unescape(string in)
        return str;
 }
 
+[[eraseable]]
 string strwords(string s, int w)
 {
        int endpos = 0;
@@ -226,6 +243,7 @@ string strwords(string s, int w)
 
 #define strhasword(s, w) (strstrofs(strcat(" ", s, " "), strcat(" ", w, " "), 0) >= 0)
 
+[[eraseable]]
 int u8_strsize(string s)
 {
        int l = 0;
@@ -238,6 +256,7 @@ int u8_strsize(string s)
        return l;
 }
 
+[[eraseable]]
 bool isInvisibleString(string s)
 {
        s = strdecolorize(s);
@@ -265,6 +284,7 @@ bool isInvisibleString(string s)
 
 // Multiline text file buffers
 
+[[eraseable]]
 int buf_load(string pFilename)
 {
        int buf = buf_create();
@@ -282,6 +302,7 @@ int buf_load(string pFilename)
        return buf;
 }
 
+[[eraseable]]
 void buf_save(float buf, string pFilename)
 {
        int fh = fopen(pFilename, FILE_WRITE);
@@ -295,6 +316,7 @@ void buf_save(float buf, string pFilename)
 /**
  * converts a number to a string with the indicated number of decimals
  */
+[[eraseable]]
 string ftos_decimals(float number, int decimals)
 {
        // inhibit stupid negative zero
@@ -305,6 +327,7 @@ string ftos_decimals(float number, int decimals)
 /**
  * converts a number to a string with the minimum number of decimals
  */
+[[eraseable]]
 string ftos_mindecimals(float number)
 {
        // inhibit stupid negative zero
@@ -312,6 +335,7 @@ string ftos_mindecimals(float number)
        return sprintf("%.7g", number);
 }
 
+[[eraseable]]
 int vercmp_recursive(string v1, string v2)
 {
        int dot1 = strstrofs(v1, ".", 0);
@@ -330,6 +354,7 @@ int vercmp_recursive(string v1, string v2)
        else return (dot2 == -1) ? 1 : vercmp_recursive(substring(v1, dot1 + 1, 999), substring(v2, dot2 + 1, 999));
 }
 
+[[eraseable]]
 int vercmp(string v1, string v2)
 {
        if (strcasecmp(v1, v2) == 0) return 0;  // early out check