strmanip.h

#pragma once
 
#include <cx/container/sarray.h>
#include <cx/string/strbase.h>
 
CX_C_BEGIN
 
enum STRING_SPECIAL {
    strEnd = 0x7fffffff   
};
 
 
bool strAppend(_Inout_ strhandle io, _In_opt_ strref s);
 
bool strAppendBytes(_Inout_ strhandle io, _In_reads_bytes_opt_(sz) const void* _Nullable buf,
                    uint32 sz);
 
void strAppendChar(_Inout_ strhandle io, uint8 ch);
 
bool strPrepend(_In_opt_ strref s, _Inout_ strhandle io);
 
bool strRepeat(_Inout_ strhandle o, _In_opt_ strref s, uint32 n);
 
bool strFillChar(_Inout_ strhandle o, uint8 ch, uint32 n);
 
bool strConcat(_Inout_ strhandle o, _In_opt_ strref s1, _In_opt_ strref s2);
 
bool strConcatC(_Inout_ strhandle o, _Inout_ strhandle sc1, _Inout_ strhandle sc2);
 
#define strNConcat(o, ...) _strNConcat(o, count_macro_args(__VA_ARGS__), (strref[]) { __VA_ARGS__ })
bool _strNConcat(_Inout_ strhandle o, int n, _In_ strref* _Nonnull stra);
 
#define strNConcatC(o, ...) \
    _strNConcatC(o, count_macro_args(__VA_ARGS__), (string*[]) { __VA_ARGS__ })
bool _strNConcatC(_Inout_ strhandle o, int n, _Inout_ strhandle* _Nonnull stra);
 
bool strSubStr(_Inout_ strhandle o, _In_opt_ strref s, int32 b, int32 e);
 
bool strSubStrC(_Inout_ strhandle o, _Inout_ strhandle sc, int32 b, int32 e);
 
bool strSubStrI(_Inout_ strhandle io, int32 b, int32 e);
 
bool strTrim(_Inout_ strhandle o, _In_opt_ strref s, _In_opt_ strref chars);
 
bool strLTrim(_Inout_ strhandle o, _In_opt_ strref s, _In_opt_ strref chars);
 
bool strRTrim(_Inout_ strhandle o, _In_opt_ strref s, _In_opt_ strref chars);
 
bool strReplaceChar(_Inout_ strhandle o, _In_opt_ strref s, char from, char to);
 
bool strReplaceChari(_Inout_ strhandle o, _In_opt_ strref s, char from, char to);
 
bool strReplace(_Inout_ strhandle o, _In_opt_ strref s, _In_opt_ strref find, _In_opt_ strref repl,
                int32 max);
 
bool strReplacei(_Inout_ strhandle o, _In_opt_ strref s, _In_opt_ strref find, _In_opt_ strref repl,
                 int32 max);
 
bool strInsert(_Inout_ strhandle o, _In_opt_ strref s, int32 off, _In_opt_ strref ins);
 
bool strErase(_Inout_ strhandle o, _In_opt_ strref s, int32 b, int32 e);
 
void strUpper(_Inout_ strhandle io);
 
void strLower(_Inout_ strhandle io);
 
int32 strSplit(_Inout_ sa_string* _Nonnull out, _In_opt_ strref s, _In_opt_ strref sep, bool empty);
 
int32 strSplitAny(_Inout_ sa_string* _Nonnull out, _In_opt_ strref s, _In_opt_ strref chars,
                  bool empty);
 
int32 strSplitMax(_Inout_ sa_string* _Nonnull out, _In_opt_ strref s, _In_opt_ strref sep,
                  bool empty, int32 maxparts);
 
int32 strSplitAnyMax(_Inout_ sa_string* _Nonnull out, _In_opt_ strref s, _In_opt_ strref chars,
                     bool empty, int32 maxparts);
 
bool strSplitNext(_In_opt_ strref s, _Inout_ int32* _Nonnull pos, _In_opt_ strref sep,
                  _Inout_ strhandle out);
 
bool strSplitNextAny(_In_opt_ strref s, _Inout_ int32* _Nonnull pos, _In_opt_ strref chars,
                     _Inout_ strhandle out);
 
bool strJoin(_Inout_ strhandle out, _In_ sa_string arr, _In_opt_ strref sep);
 
uint8 strGetChar(_In_opt_ strref str, int32 i);
 
void strSetChar(_Inout_ strhandle str, int32 i, uint8 ch);
 
 
CX_C_END