|
|
/****************************************************************************\
STRAPI.C / OPK Wizard (OPKWIZ.EXE)
Microsoft Confidential Copyright (c) Microsoft Corporation 1999 All rights reserved
String API source file for generic APIs used in the OPK Wizard.
4/99 - Jason Cohen (JCOHEN) Added this new source file for the OPK Wizard as part of the Millennium rewrite. 7/00 - Brian Ku (BRIANK) Added to Whistler
\****************************************************************************/
//
// Include file(s)
//
#include <pch.h>
#include <tchar.h>
//
// Internal Defined Value(s):
//
#define NULLCHR _T('\0')
//
// External Function(s):
//
/****************************************************************************\
LPTSTR // Returns a pointer to the first occurance of a
// character in a string, or NULL if the
// character isn't found.
StrChr( // Searches a string for a particular character.
LPCTSTR lpString, // Points to a string buffer to search.
TCHAR cSearch // Character to search for.
);
\****************************************************************************/#ifndef _INC_SHLWAPI
LPTSTR StrChr(LPCTSTR lpString, TCHAR cSearch){ // Validate the parameters passed in.
//
if ( ( lpString == NULL ) || ( *lpString == NULLCHR ) ) return NULL;
// Go through the string until the character is found,
// or we hit the null terminator.
//
while ( ( *lpString != cSearch ) && ( *(lpString = CharNext(lpString)) ) );
// If we didn't find it, null the pointer out.
//
if ( *lpString != cSearch ) lpString = NULL;
// Return either null or a pointer to the found character.
//
return (LPTSTR) lpString;}
/****************************************************************************\
LPTSTR // Returns a pointer to the last occurance of a
// character in a string, or NULL if the
// character isn't found.
StrRChr( // Searches a string for a particular character.
LPCTSTR lpString, // Points to a string buffer to search.
TCHAR cSearch // Character to search for.
);
\****************************************************************************/
LPTSTR StrRChr(LPCTSTR lpString, TCHAR cSearch){ LPTSTR lpSearch;
// Validate the parameters passed in.
//
if ( ( lpString == NULL ) || ( *lpString == NULLCHR ) ) return NULL;
// Go back through the string until the character is found,
// or we hit the begining of the string.
//
for ( lpSearch = (LPTSTR) lpString + lstrlen(lpString); ( lpSearch > lpString ) && ( *lpSearch != cSearch ); lpSearch = CharPrev(lpString, lpSearch));
// If we didn't find it, null the pointer out.
//
if ( *lpSearch != cSearch ) lpSearch = NULL;
// Return either null or a pointer to the found character.
//
return (LPTSTR) lpSearch;}#endif // _INC_SHLWAPI
/****************************************************************************\
LPTSTR // Returns a pointer to the string buffer passed
// in.
StrRem( // Searches a string for a particular character
// and removes that character from the string in
// place.
LPCTSTR lpString, // Points to a string buffer to search and remove
// the characters from.
TCHAR cRemove // Character to search for and remove.
);
\****************************************************************************/
LPTSTR StrRem(LPTSTR lpString, TCHAR cRemove){ LPTSTR lpSearch;
// Validate the parameters passed in.
//
if ( ( lpString == NULL ) || ( *lpString == NULLCHR ) || ( cRemove == NULLCHR ) ) return lpString;
// Search the string for the character we want to remove.
// Everytime we find it, shift the string over a character
// to remove it.
//
for ( lpSearch = StrChr(lpString, cRemove); lpSearch; lpSearch = StrChr(lpSearch, cRemove) ) lstrcpy(lpSearch, lpSearch + 1);
// Return the pointer to the string passed in.
//
return lpString;}
/****************************************************************************\
LPTSTR // Returns a pointer to the string buffer passed
// in.
StrRTrm( // Searches a string for a particular ending
// character, and removes all of them from the
// ending of the string.
LPCTSTR lpString, // Points to a string buffer to search and remove
// the characters from.
TCHAR cTrim // Character to search for and remove.
);
\****************************************************************************/
LPTSTR StrRTrm(LPTSTR lpString, TCHAR cTrim){ LPTSTR lpEnd;
// Validate the parameters passed in.
//
if ( ( lpString == NULL ) || ( *lpString == NULLCHR ) || ( cTrim == NULLCHR ) ) return lpString;
// Null out the end of the string minus
// the chacters we are trimming.
//
for ( lpEnd = lpString + lstrlen(lpString); (lpEnd > lpString) && (*CharPrev(lpString, lpEnd) == cTrim); lpEnd = CharPrev(lpString, lpEnd) ); *lpEnd = NULLCHR;
return lpString;}
/****************************************************************************\
LPTSTR // Returns a pointer to the string buffer passed
// in.
StrTrm( // Searches a string for a particular proceeding
// and ending character, and removes all of them
// from the beginning and ending of the string.
LPCTSTR lpString, // Points to a string buffer to search and remove
// the characters from.
TCHAR cTrim // Character to search for and remove.
);
\****************************************************************************/
LPTSTR StrTrm(LPTSTR lpString, TCHAR cTrim){ LPTSTR lpBegin;
// Validate the parameters passed in.
//
if ( ( lpString == NULL ) || ( *lpString == NULLCHR ) || ( cTrim == NULLCHR ) ) return lpString;
// Get a pointer to the begining of the string
// minus the characters we are trimming.
//
for ( lpBegin = lpString; *lpBegin == cTrim; lpBegin = CharNext(lpBegin) );
// Make sure we didn't hit the null terminator.
//
if ( *lpBegin == NULLCHR ) { *lpString = NULLCHR; return lpString; }
// Null out the end of the string minus
// the chacters we are trimming.
//
StrRTrm(lpBegin, cTrim);
// Now we may need to move the string to the beginning
// of the buffer if we trimmed of proceeding characters.
//
if ( lpBegin > lpString ) lstrcpy(lpString, lpBegin);
return lpString;}
/****************************************************************************\
LPTSTR // Returns a pointer to the string a character in
// the string passed in.
StrMov( // Moves a pointer forward or backward the number
// of characters passed in.
LPCTSTR lpStart, // Pointer to the begining of the string buffer.
// This may only be NULL if nCount is positive.
LPCTSTR lpCurrent, // Pointer to a character in the null-terminated
// string.
INT nCount // Number of characters to move the pointer,
// forward if it is a positive value, backward
// if it is negative.
);
\****************************************************************************/
LPTSTR StrMov(LPTSTR lpStart, LPTSTR lpCurrent, INT nCount){ // Validate the parameters.
//
if ( ( lpCurrent == NULL ) || ( ( lpStart == NULL ) && ( nCount < 0 ) ) ) { return lpCurrent; }
// Loop throuh until we don't need to move the pointer anymore.
//
while ( nCount != 0 ) { // Check to see if we are moving forward or backward.
//
if ( nCount > 0 ) { // Move the pointer forward one character.
//
lpCurrent = CharNext(lpCurrent); nCount--; } else { // Move the pointer backward one character.
//
lpCurrent = CharPrev(lpStart, lpCurrent); nCount++; } }
// Return the pointer to the new position.
//
return lpCurrent;}
|
