stringutils.h File Reference

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	NewAnsiString(x)   DuplicateStringA(x)
#define	NewPortableString(x)   DuplicateString(x)
#define	DuplicateString(x)   DuplicateStringA(x)
#define	DuplicateStringEx(x, y)   DuplicateStringAEx((x), (y))
#define	FindSubStr(str, strSearch)   _tcsstr((str), (strSearch))

Functions
LPTSTR	FormatStringV (LPCTSTR str, va_list args)
LPTSTR	FormatString (LPCTSTR str,...)
LPSTR	UnicodeToAnsi (LPCWSTR strW)
LPWSTR	AnsiToUnicode (LPCSTR strA)
LPSTR	DuplicateStringA (LPCSTR str)
LPWSTR	DuplicateStringW (LPCWSTR str)
LPSTR	DuplicateStringAEx (LPCSTR str, size_t numOfChars)
LPWSTR	DuplicateStringWEx (LPCWSTR str, size_t numOfChars)
LPTSTR	FindSubStrI (LPCTSTR str, LPCTSTR strSearch)
LPTSTR	AppendPathSeparator (LPTSTR lpszPath)

Macro Definition Documentation

DuplicateString

#define DuplicateString

(

x

)

DuplicateStringA(x)

Definition at line 45 of file stringutils.h.

DuplicateStringEx

#define DuplicateStringEx	(		x,
			y
	)		DuplicateStringAEx((x), (y))

Definition at line 46 of file stringutils.h.

FindSubStr

#define FindSubStr	(		str,
			strSearch
	)		_tcsstr((str), (strSearch))

Definition at line 52 of file stringutils.h.

NewAnsiString

#define NewAnsiString

(

x

)

DuplicateStringA(x)

Definition at line 43 of file stringutils.h.

NewPortableString

#define NewPortableString

(

x

)

DuplicateString(x)

Definition at line 44 of file stringutils.h.

Function Documentation

AnsiToUnicode()

LPWSTR AnsiToUnicode

(

LPCSTR

strA

)

Definition at line 69 of file stringutils.c.

{
    LPWSTR strW;
    int iNeededChars;
 
    if (!strA) return NULL;
 
    iNeededChars = MultiByteToWideChar(CP_ACP,
                                       MB_PRECOMPOSED,
                                       strA, -1, NULL, 0);
 
    strW = (LPWSTR)MemAlloc(0, iNeededChars * sizeof(WCHAR));
    if (!strW) return NULL;
 
    MultiByteToWideChar(CP_ACP,
                        MB_PRECOMPOSED,
                        strA, -1, strW, iNeededChars);
 
    return strW;
}

AppendPathSeparator()

LPTSTR AppendPathSeparator

(

LPTSTR

lpszPath

)

Definition at line 220 of file stringutils.c.

{
    size_t iLen = 0;
 
    if (!lpszPath || (iLen = _tcslen(lpszPath)) >= MAX_PATH)
        return NULL;
 
    if (iLen >= 1)
    {
        lpszPath += iLen - 1;
        if (*lpszPath++ != _T('\\'))
        {
            *lpszPath++ = _T('\\');
            *lpszPath   = _T('\0');
        }
    }
 
    return lpszPath;
}

DuplicateStringA()

LPSTR DuplicateStringA

(

LPCSTR

str

)

Definition at line 90 of file stringutils.c.

{
    LPSTR dupStr;
    size_t strSizePlusNull;
 
    if (!str) return NULL;
 
    strSizePlusNull = strlen(str) + 1;
 
    dupStr = (LPSTR)MemAlloc(0, strSizePlusNull * sizeof(CHAR));
    if (!dupStr) return NULL;
 
    StringCchCopyA(dupStr, strSizePlusNull, str);
 
    return dupStr;
}

DuplicateStringAEx()

LPSTR DuplicateStringAEx	(	LPCSTR	str,
		size_t	numOfChars
	)

Definition at line 124 of file stringutils.c.

{
    LPSTR dupStr;
    size_t strSize;
 
    if (!str) return NULL;
 
    strSize = min(strlen(str), numOfChars);
 
    dupStr = (LPSTR)MemAlloc(0, (strSize + 1) * sizeof(CHAR));
    if (!dupStr) return NULL;
 
    StringCchCopyNA(dupStr, strSize + 1, str, strSize);
    dupStr[strSize] = '\0';
 
    return dupStr;
}

DuplicateStringW()

LPWSTR DuplicateStringW

(

LPCWSTR

str

)

Definition at line 107 of file stringutils.c.

{
    LPWSTR dupStr;
    size_t strSizePlusNull;
 
    if (!str) return NULL;
 
    strSizePlusNull = wcslen(str) + 1;
 
    dupStr = (LPWSTR)MemAlloc(0, strSizePlusNull * sizeof(WCHAR));
    if (!dupStr) return NULL;
 
    StringCchCopyW(dupStr, strSizePlusNull, str);
 
    return dupStr;
}

DuplicateStringWEx()

LPWSTR DuplicateStringWEx	(	LPCWSTR	str,
		size_t	numOfChars
	)

Definition at line 142 of file stringutils.c.

{
    LPWSTR dupStr;
    size_t strSize;
 
    if (!str) return NULL;
 
    strSize = min(wcslen(str), numOfChars);
 
    dupStr = (LPWSTR)MemAlloc(0, (strSize + 1) * sizeof(WCHAR));
    if (!dupStr) return NULL;
 
    StringCchCopyNW(dupStr, strSize + 1, str, strSize);
    dupStr[strSize] = L'\0';
 
    return dupStr;
}

FindSubStrI()

LPTSTR FindSubStrI	(	LPCTSTR	str,
		LPCTSTR	strSearch
	)

Definition at line 183 of file stringutils.c.

{
    LPTSTR cp = (LPTSTR)str;
    LPTSTR s1, s2;
 
    if (!*strSearch)
        return (LPTSTR)str;
 
    while (*cp)
    {
        s1 = cp;
        s2 = (LPTSTR)strSearch;
 
        while (*s1 && *s2 && (_totupper(*s1) == _totupper(*s2)))
            ++s1, ++s2;
 
        if (!*s2)
            return cp;
 
        ++cp;
    }
 
    return NULL;
}

Referenced by AddNTOSInstallationItem(), AddService(), and IsWindowsOS().

FormatString()

LPTSTR FormatString	(	LPCTSTR	str,
			...
	)

Definition at line 33 of file stringutils.c.

{
    LPTSTR lpszString;
    va_list args;
 
    va_start(args, str);
    lpszString = FormatStringV(str, args);
    va_end(args);
 
    return lpszString;
}

FormatStringV()

LPTSTR FormatStringV	(	LPCTSTR	str,
		va_list	args
	)

Definition at line 16 of file stringutils.c.

{
    LPTSTR lpszString;
    size_t strLenPlusNull;
 
    if (!str) return NULL;
 
    strLenPlusNull = _vsctprintf(str, args) + 1;
 
    lpszString = (LPTSTR)MemAlloc(0, strLenPlusNull * sizeof(TCHAR));
    if (!lpszString) return NULL;
 
    StringCchVPrintf(lpszString, strLenPlusNull, str, args);
 
    return lpszString;
}

Referenced by FormatString().

UnicodeToAnsi()

LPSTR UnicodeToAnsi

(

LPCWSTR

strW

)

Definition at line 48 of file stringutils.c.

{
    LPSTR strA;
    int iNeededChars;
 
    if (!strW) return NULL;
 
    iNeededChars = WideCharToMultiByte(CP_ACP,
                                       WC_COMPOSITECHECK /* | WC_NO_BEST_FIT_CHARS */,
                                       strW, -1, NULL, 0, NULL, NULL);
 
    strA = (LPSTR)MemAlloc(0, iNeededChars * sizeof(CHAR));
    if (!strA) return NULL;
 
    WideCharToMultiByte(CP_ACP,
                        WC_COMPOSITECHECK /* | WC_NO_BEST_FIT_CHARS */,
                        strW, -1, strA, iNeededChars, NULL, NULL);
 
    return strA;
}