ZFCoreStringUtil.h

Go to the documentation of this file.

 
#ifndef _ZFI_ZFCoreStringUtil_h_
#define _ZFI_ZFCoreStringUtil_h_
 
#include "ZFCoreArray.h"
#include "ZFCoreStringConvert.h"
 
ZF_NAMESPACE_GLOBAL_BEGIN
 
// ============================================================
extern ZFLIB_ZFCore zfindex zfsCheckMatch(
        ZF_IN const zfchar **tokens
        , ZF_IN zfindex tokenCount
        , ZF_IN const zfchar *toCompare
        , ZF_IN_OPT zfindex toCompareLength = zfindexMax()
        );
 
// ============================================================
inline zfbool zfstringIsEqual(
        ZF_IN const zfchar *s1
        , ZF_IN const zfchar *s2
        ) {
    if(s1 == s2) {
        return zftrue;
    }
    else if(!s1) {
        return (*s2 == '\0');
    }
    else if(!s2) {
        return (*s1 == '\0');
    }
    else {
        return (zfscmp(s1, s2) == 0);
    }
}

inline zfbool zfstringIsEqual(
        ZF_IN const zfchar *s1
        , ZF_IN zfindex s1Len
        , ZF_IN const zfchar *s2
        , ZF_IN zfindex s2Len
        ) {
    if(s1 == s2) {
        return zftrue;
    }
    else if(!s1 || s1Len == 0) {
        return (s2Len == 0 || *s2 == '\0');
    }
    else if(!s2 || s2Len == 0) {
        return (s1Len == 0 || *s1 == '\0');
    }
    else {
        if(s1Len == zfindexMax()) {
            s1Len = zfslen(s1);
        }
        if(s2Len == zfindexMax()) {
            s2Len = zfslen(s2);
        }
        return (s1Len == s2Len && zfsncmp(s1, s2, s1Len) == 0);
    }
}

inline zfbool zfstringIsEmpty(ZF_IN const zfchar *s) {
    return (s == zfnull || *s == '\0');
}

inline zfbool zfstringIsEmpty(ZF_IN const zfchar *s, ZF_IN zfindex len) {
    return (s == zfnull || *s == '\0' || len == 0);
}
 
// ============================================================
// zfstringFind
extern ZFLIB_ZFCore zfindex zfstringFind(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFind(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFind(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFind(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFind(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindReversely
extern ZFLIB_ZFCore zfindex zfstringFindReversely(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindReversely(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindReversely(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindReversely(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindReversely(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindCaseInsensitive
extern ZFLIB_ZFCore zfindex zfstringFindCaseInsensitive(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindCaseInsensitive(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindCaseInsensitive(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindCaseInsensitive(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindCaseInsensitive(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindCaseInsensitiveReversely
extern ZFLIB_ZFCore zfindex zfstringFindCaseInsensitiveReversely(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindCaseInsensitiveReversely(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindCaseInsensitiveReversely(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindCaseInsensitiveReversely(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindCaseInsensitiveReversely(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindFirstOf
extern ZFLIB_ZFCore zfindex zfstringFindFirstOf(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindFirstOf(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindFirstOf(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindFirstOf(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindFirstOf(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindFirstNotOf
extern ZFLIB_ZFCore zfindex zfstringFindFirstNotOf(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindFirstNotOf(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindFirstNotOf(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindFirstNotOf(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindFirstNotOf(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindLastOf
extern ZFLIB_ZFCore zfindex zfstringFindLastOf(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindLastOf(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindLastOf(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindLastOf(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindLastOf(src, src.length(), find, findLen);
}
// ============================================================
// zfstringFindLastNotOf
extern ZFLIB_ZFCore zfindex zfstringFindLastNotOf(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfindex zfstringFindLastNotOf(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindLastNotOf(src, zfindexMax(), find, findLen);
}

inline zfindex zfstringFindLastNotOf(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringFindLastNotOf(src, src.length(), find, findLen);
}
// ============================================================
// zfstringReplace
extern ZFLIB_ZFCore zfstring zfstringReplace(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *replaceFrom
        , ZF_IN const zfchar *replaceTo
        , ZF_IN_OPT zfindex maxCount = zfindexMax()
        , ZF_OUT_OPT zfindex *replacedCount = zfnull
        );
extern ZFLIB_ZFCore zfstring zfstringReplaceReversely(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *replaceFrom
        , ZF_IN const zfchar *replaceTo
        , ZF_IN_OPT zfindex maxCount = zfindexMax()
        , ZF_OUT_OPT zfindex *replacedCount = zfnull
        );
 
// ============================================================
// zfstringBeginWith
extern ZFLIB_ZFCore zfbool zfstringBeginWith(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfbool zfstringBeginWith(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringBeginWith(src, zfindexMax(), find, findLen);
}

inline zfbool zfstringBeginWith(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringBeginWith(src, src.length(), find, findLen);
}
// ============================================================
// zfstringEndWith
extern ZFLIB_ZFCore zfbool zfstringEndWith(
        ZF_IN const zfchar *src
        , ZF_IN zfindex srcLen
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        );
inline zfbool zfstringEndWith(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringEndWith(src, zfindexMax(), find, findLen);
}

inline zfbool zfstringEndWith(
        ZF_IN const zfstring &src
        , ZF_IN const zfchar *find
        , ZF_IN_OPT zfindex findLen = zfindexMax()
        ) {
    return zfstringEndWith(src, src.length(), find, findLen);
}
 
// ============================================================
// zfstringSplit
extern ZFLIB_ZFCore void zfstringSplitT(
        ZF_IN_OUT ZFCoreArray<zfstring> &ret
        , ZF_IN const zfchar *src
        , ZF_IN const zfchar *separator
        , ZF_IN_OPT zfbool keepEmpty = zffalse
        );
inline ZFCoreArray<zfstring> zfstringSplit(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *separator
        , ZF_IN_OPT zfbool keepEmpty = zffalse
        ) {
    ZFCoreArray<zfstring> ret;
    zfstringSplitT(ret, src, separator, keepEmpty);
    return ret;
}

extern ZFLIB_ZFCore void zfstringSplitIndexT(
        ZF_IN_OUT ZFCoreArray<ZFIndexRange> &ret
        , ZF_IN const zfchar *src
        , ZF_IN const zfchar *separator
        , ZF_IN_OPT zfbool keepEmpty = zffalse
        );
inline ZFCoreArray<ZFIndexRange> zfstringSplitIndex(
        ZF_IN const zfchar *src
        , ZF_IN const zfchar *separator
        , ZF_IN_OPT zfbool keepEmpty = zffalse
        ) {
    ZFCoreArray<ZFIndexRange> ret;
    zfstringSplitIndexT(ret, src, separator, keepEmpty);
    return ret;
}
 
// ============================================================
// other
extern ZFLIB_ZFCore void zfstringToLowerT(ZF_IN_OUT zfstring &ret);
extern ZFLIB_ZFCore void zfstringToLowerT(
        ZF_IN_OUT zfstring &ret
        , ZF_IN const zfchar *src
        , ZF_IN_OPT zfindex srcLen = zfindexMax()
        );
inline zfstring zfstringToLower(
        ZF_IN const zfchar *src
        , ZF_IN_OPT zfindex srcLen = zfindexMax()
        ) {
    zfstring ret;
    zfstringToLowerT(ret, src, srcLen);
    return ret;
}

extern ZFLIB_ZFCore void zfstringToUpperT(ZF_IN_OUT zfstring &ret);
extern ZFLIB_ZFCore void zfstringToUpperT(
        ZF_IN_OUT zfstring &ret
        , ZF_IN const zfchar *src
        , ZF_IN_OPT zfindex srcLen = zfindexMax()
        );
inline zfstring zfstringToUpper(
        ZF_IN const zfchar *src
        , ZF_IN_OPT zfindex srcLen = zfindexMax()
        ) {
    zfstring ret;
    zfstringToUpperT(ret, src, srcLen);
    return ret;
}

inline void zfstringRepeatT(
        ZF_IN_OUT zfstring &ret
        , ZF_IN const zfchar *token
        , ZF_IN zfindex count
        ) {
    if(count != 0 && !zfstringIsEmpty(token)) {
        zfindex len = zfslen(token);
        for(zfindex i = 0; i < count; ++i) {
            ret.append(token, len);
        }
    }
}

inline zfstring zfstringRepeat(
        ZF_IN const zfchar *token
        , ZF_IN zfindex count
        ) {
    zfstring ret;
    zfstringRepeatT(ret, token, count);
    return ret;
}

#define zfstringSwitch(v, c0, ...) _ZFP_zfstringSwitch(v, c0 \
        ZFM_FIX_PARAM(_ZFP_zfstringSwitchExpand, ZFM_EMPTY, ##__VA_ARGS__) \
        , zfnull)
#define _ZFP_zfstringSwitchExpand(arg) , ((const zfchar *)(arg))
extern ZFLIB_ZFCore zfindex _ZFP_zfstringSwitch(
        ZF_IN const zfchar *v
        , ZF_IN const zfchar *c0
        , ...
        );
 
ZF_NAMESPACE_GLOBAL_END
 
#endif // #ifndef _ZFI_ZFCoreStringUtil_h_