CPStringUtils.cpp File Reference

#include "CPStringUtils.hpp"
#include "ErrorHandling.hpp"

Go to the source code of this file.

Macros
#define	kNumberFormatString   "\p########0.00#######;-########0.00#######"

Functions
void	CopyPStrToCStr (const unsigned char *thePStr, char *theCStr, const int maxCStrLength)
void	CopyPStrToPStr (const unsigned char *theSrcPStr, unsigned char *theDstPStr, const int maxDstStrLength)
void	CopyCStrToCStr (const char *theSrcCStr, char *theDstCStr, const int maxDstStrLength)
void	CopyCSubstrToCStr (const char *theSrcCStr, const int maxCharsToCopy, char *theDstCStr, const int maxDstStrLength)
void	CopyCSubstrToPStr (const char *theSrcCStr, const int maxCharsToCopy, unsigned char *theDstPStr, const int maxDstStrLength)
void	CopyCStrToPStr (const char *theSrcCStr, unsigned char *theDstPStr, const int maxDstStrLength)
void	ConcatPStrToCStr (const unsigned char *thePStr, char *theCStr, const int maxCStrLength)
void	ConcatPStrToPStr (const unsigned char *theSrcPStr, unsigned char *theDstPStr, const int maxDstStrLength)
void	ConcatCStrToPStr (const char *theSrcCStr, unsigned char *theDstPStr, const int maxDstStrLength)
void	ConcatCStrToCStr (const char *theSrcCStr, char *theDstCStr, const int maxCStrLength)
void	ConcatCharToCStr (const char theChar, char *theDstCStr, const int maxCStrLength)
void	ConcatCharToPStr (const char theChar, unsigned char *theDstPStr, const int maxPStrLength)
int	CompareCStrs (const char *theFirstCStr, const char *theSecondCStr, const Boolean ignoreCase)
Boolean	CStrsAreEqual (const char *theFirstCStr, const char *theSecondCStr, const Boolean ignoreCase)
Boolean	PStrsAreEqual (const unsigned char *theFirstPStr, const unsigned char *theSecondPStr, const Boolean ignoreCase)
int	ComparePStrs (const unsigned char *theFirstPStr, const unsigned char *theSecondPStr, const Boolean ignoreCase)
int	CompareCStrToPStr (const char *theCStr, const unsigned char *thePStr, const Boolean ignoreCase)
void	ConcatLongIntToCStr (const long theNum, char *theCStr, const int maxCStrLength, const int numDigits)
void	ConcatLongIntToPStr (const long theNum, unsigned char *thePStr, const int maxPStrLength, const int numDigits)
void	CopyCStrAndConcatLongIntToCStr (const char *theSrcCStr, const long theNum, char *theDstCStr, const int maxDstStrLength)
void	CopyLongIntToCStr (const long theNum, char *theCStr, const int maxCStrLength, const int numDigits)
void	CopyUnsignedLongIntToCStr (const unsigned long theNum, char *theCStr, const int maxCStrLength)
void	CopyLongIntToPStr (const long theNum, unsigned char *thePStr, const int maxPStrLength, const int numDigits)
OSErr	CopyLongIntToNewHandle (const long inTheLongInt, Handle *theHandle)
OSErr	CopyLongIntToExistingHandle (const long inTheLongInt, Handle theHandle)
OSErr	CopyCStrToExistingHandle (const char *theCString, Handle theHandle)
OSErr	CopyCStrToNewHandle (const char *theCString, Handle *theHandle)
OSErr	CopyPStrToNewHandle (const unsigned char *thePString, Handle *theHandle)
OSErr	AppendPStrToHandle (const unsigned char *thePString, Handle theHandle, long *currentLength)
OSErr	AppendCStrToHandle (const char *theCString, Handle theHandle, long *currentLength, long *maxLength)
OSErr	AppendCharsToHandle (const char *theChars, const int numChars, Handle theHandle, long *currentLength, long *maxLength)
OSErr	AppendLongIntToHandle (const long inTheLongInt, Handle theHandle, long *currentLength)
long	CStrLength (const char *theCString)
long	PStrLength (const unsigned char *thePString)
void	ZeroMem (void *theMemPtr, const unsigned long numBytes)
char *	FindCharInCStr (const char theChar, const char *theCString)
long	FindCharOffsetInCStr (const char theChar, const char *theCString, const Boolean inIgnoreCase)
long	FindCStrOffsetInCStr (const char *theCSubstring, const char *theCString, const Boolean inIgnoreCase)
void	InsertCStrIntoCStr (const char *theSrcCStr, const int theInsertionOffset, char *theDstCStr, const int maxDstStrLength)
void	InsertPStrIntoCStr (const unsigned char *theSrcPStr, const int theInsertionOffset, char *theDstCStr, const int maxDstStrLength)
OSErr	InsertCStrIntoHandle (const char *theCString, Handle theHandle, const long inInsertOffset)
void	CopyCStrAndInsert1LongIntIntoCStr (const char *theSrcCStr, const long theNum, char *theDstCStr, const int maxDstStrLength)
void	CopyCStrAndInsert2LongIntsIntoCStr (const char *theSrcCStr, const long long1, const long long2, char *theDstCStr, const int maxDstStrLength)
void	CopyCStrAndInsert3LongIntsIntoCStr (const char *theSrcCStr, const long long1, const long long2, const long long3, char *theDstCStr, const int maxDstStrLength)
void	CopyCStrAndInsertCStrIntoCStr (const char *theSrcCStr, const char *theInsertCStr, char *theDstCStr, const int maxDstStrLength)
void	CopyCStrAndInsertCStrLongIntIntoCStr (const char *theSrcCStr, const char *theInsertCStr, const long theNum, char *theDstCStr, const int maxDstStrLength)
void	CopyCStrAndInsertCStrsLongIntsIntoCStr (const char *theSrcCStr, const char **theInsertCStrs, const long *theLongInts, char *theDstCStr, const int maxDstStrLength)
OSErr	CopyCStrAndInsertCStrLongIntIntoHandle (const char *theSrcCStr, const char *theInsertCStr, const long theNum, Handle *theHandle)
OSErr	CopyIndexedWordToCStr (char *theSrcCStr, int whichWord, char *theDstCStr, int maxDstCStrLength)
OSErr	CopyIndexedWordToNewHandle (char *theSrcCStr, int whichWord, Handle *outTheHandle)
OSErr	CopyIndexedLineToCStr (const char *theSrcCStr, int inWhichLine, int *lineEndIndex, Boolean *gotLastLine, char *theDstCStr, const int maxDstCStrLength)
OSErr	CopyIndexedLineToNewHandle (const char *theSrcCStr, int inWhichLine, Handle *outNewHandle)
OSErr	CountDigits (const char *inCStr, int *outNumIntegerDigits, int *outNumFractDigits)
OSErr	ExtractIntFromCStr (const char *theSrcCStr, int *outInt, Boolean skipLeadingSpaces)
OSErr	ExtractIntFromPStr (const unsigned char *theSrcPStr, int *outInt, Boolean skipLeadingSpaces)
int	CountOccurencesOfCharInCStr (const char inChar, const char *inSrcCStr)
int	CountWordsInCStr (const char *inSrcCStr)
void	ConvertCStrToUpperCase (char *theSrcCStr)
void	ExtractCStrItemFromCStr (const char *inSrcCStr, const char inItemDelimiter, const int inItemNumber, Boolean *foundItem, char *outDstCharPtr, const int inDstCharPtrMaxLength, const Boolean inTreatMultipleDelimsAsSingleDelim)
OSErr	ExtractCStrItemFromCStrIntoNewHandle (const char *inSrcCStr, const char inItemDelimiter, const int inItemNumber, Boolean *foundItem, Handle *outNewHandle, const Boolean inTreatMultipleDelimsAsSingleDelim)
OSErr	ExtractFloatFromCStr (const char *inCString, extended80 *outFloat)
OSErr	CopyFloatToCStr (const extended80 *theFloat, char *theCStr, const int maxCStrLength, const int inMaxNumIntDigits, const int inMaxNumFractDigits)
void	SkipWhiteSpace (char **ioSrcCharPtr, const Boolean inStopAtEOL)

Macro Definition Documentation

#define kNumberFormatString   "\p########0.00#######;-########0.00#######"

Definition at line 62 of file CPStringUtils.cpp.

Function Documentation

OSErr AppendCharsToHandle	(	const char *	theChars,
		const int	numChars,
		Handle	theHandle,
		long *	currentLength,
		long *	maxLength
	)

Definition at line 1075 of file CPStringUtils.cpp.

OSErr AppendCStrToHandle	(	const char *	theCString,
		Handle	theHandle,
		long *	currentLength,
		long *	maxLength
	)

Definition at line 990 of file CPStringUtils.cpp.

OSErr AppendLongIntToHandle	(	const long	inTheLongInt,
		Handle	theHandle,
		long *	currentLength
	)

Definition at line 1159 of file CPStringUtils.cpp.

OSErr AppendPStrToHandle	(	const unsigned char *	thePString,
		Handle	theHandle,
		long *	currentLength
	)

Definition at line 972 of file CPStringUtils.cpp.

int CompareCStrs	(	const char *	theFirstCStr,
		const char *	theSecondCStr,
		const Boolean	ignoreCase
	)

Definition at line 426 of file CPStringUtils.cpp.

int CompareCStrToPStr	(	const char *	theCStr,
		const unsigned char *	thePStr,
		const Boolean	ignoreCase
	)

Definition at line 604 of file CPStringUtils.cpp.

int ComparePStrs	(	const unsigned char *	theFirstPStr,
		const unsigned char *	theSecondPStr,
		const Boolean	ignoreCase
	)

Definition at line 531 of file CPStringUtils.cpp.

void ConcatCharToCStr	(	const char	theChar,
		char *	theDstCStr,
		const int	maxCStrLength
	)

Definition at line 387 of file CPStringUtils.cpp.

void ConcatCharToPStr	(	const char	theChar,
		unsigned char *	theDstPStr,
		const int	maxPStrLength
	)

Definition at line 406 of file CPStringUtils.cpp.

void ConcatCStrToCStr	(	const char *	theSrcCStr,
		char *	theDstCStr,
		const int	maxCStrLength
	)

Definition at line 355 of file CPStringUtils.cpp.

void ConcatCStrToPStr	(	const char *	theSrcCStr,
		unsigned char *	theDstPStr,
		const int	maxDstStrLength
	)

Definition at line 316 of file CPStringUtils.cpp.

void ConcatLongIntToCStr	(	const long	theNum,
		char *	theCStr,
		const int	maxCStrLength,
		const int	numDigits
	)

Definition at line 625 of file CPStringUtils.cpp.

void ConcatLongIntToPStr	(	const long	theNum,
		unsigned char *	thePStr,
		const int	maxPStrLength,
		const int	numDigits
	)

Definition at line 664 of file CPStringUtils.cpp.

void ConcatPStrToCStr	(	const unsigned char *	thePStr,
		char *	theCStr,
		const int	maxCStrLength
	)

Definition at line 248 of file CPStringUtils.cpp.

void ConcatPStrToPStr	(	const unsigned char *	theSrcPStr,
		unsigned char *	theDstPStr,
		const int	maxDstStrLength
	)

Definition at line 283 of file CPStringUtils.cpp.

void ConvertCStrToUpperCase

(

char *

theSrcCStr

)

Definition at line 2293 of file CPStringUtils.cpp.

void CopyCStrAndConcatLongIntToCStr	(	const char *	theSrcCStr,
		const long	theNum,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 702 of file CPStringUtils.cpp.

void CopyCStrAndInsert1LongIntIntoCStr	(	const char *	theSrcCStr,
		const long	theNum,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1558 of file CPStringUtils.cpp.

void CopyCStrAndInsert2LongIntsIntoCStr	(	const char *	theSrcCStr,
		const long	long1,
		const long	long2,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1564 of file CPStringUtils.cpp.

void CopyCStrAndInsert3LongIntsIntoCStr	(	const char *	theSrcCStr,
		const long	long1,
		const long	long2,
		const long	long3,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1572 of file CPStringUtils.cpp.

void CopyCStrAndInsertCStrIntoCStr	(	const char *	theSrcCStr,
		const char *	theInsertCStr,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1580 of file CPStringUtils.cpp.

void CopyCStrAndInsertCStrLongIntIntoCStr	(	const char *	theSrcCStr,
		const char *	theInsertCStr,
		const long	theNum,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1589 of file CPStringUtils.cpp.

OSErr CopyCStrAndInsertCStrLongIntIntoHandle	(	const char *	theSrcCStr,
		const char *	theInsertCStr,
		const long	theNum,
		Handle *	theHandle
	)

Definition at line 1698 of file CPStringUtils.cpp.

void CopyCStrAndInsertCStrsLongIntsIntoCStr	(	const char *	theSrcCStr,
		const char **	theInsertCStrs,
		const long *	theLongInts,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1599 of file CPStringUtils.cpp.

void CopyCStrToCStr	(	const char *	theSrcCStr,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 127 of file CPStringUtils.cpp.

OSErr CopyCStrToExistingHandle	(	const char *	theCString,
		Handle	theHandle
	)

Definition at line 847 of file CPStringUtils.cpp.

OSErr CopyCStrToNewHandle	(	const char *	theCString,
		Handle *	theHandle
	)

Definition at line 892 of file CPStringUtils.cpp.

void CopyCStrToPStr	(	const char *	theSrcCStr,
		unsigned char *	theDstPStr,
		const int	maxDstStrLength
	)

Definition at line 214 of file CPStringUtils.cpp.

void CopyCSubstrToCStr	(	const char *	theSrcCStr,
		const int	maxCharsToCopy,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 153 of file CPStringUtils.cpp.

void CopyCSubstrToPStr	(	const char *	theSrcCStr,
		const int	maxCharsToCopy,
		unsigned char *	theDstPStr,
		const int	maxDstStrLength
	)

Definition at line 179 of file CPStringUtils.cpp.

OSErr CopyFloatToCStr	(	const extended80 *	theFloat,
		char *	theCStr,
		const int	maxCStrLength,
		const int	inMaxNumIntDigits,
		const int	inMaxNumFractDigits
	)

Definition at line 2591 of file CPStringUtils.cpp.

OSErr CopyIndexedLineToCStr	(	const char *	theSrcCStr,
		int	inWhichLine,
		int *	lineEndIndex,
		Boolean *	gotLastLine,
		char *	theDstCStr,
		const int	maxDstCStrLength
	)

Definition at line 1922 of file CPStringUtils.cpp.

OSErr CopyIndexedLineToNewHandle	(	const char *	theSrcCStr,
		int	inWhichLine,
		Handle *	outNewHandle
	)

Definition at line 2031 of file CPStringUtils.cpp.

OSErr CopyIndexedWordToCStr	(	char *	theSrcCStr,
		int	whichWord,
		char *	theDstCStr,
		int	maxDstCStrLength
	)

Definition at line 1735 of file CPStringUtils.cpp.

OSErr CopyIndexedWordToNewHandle	(	char *	theSrcCStr,
		int	whichWord,
		Handle *	outTheHandle
	)

Definition at line 1832 of file CPStringUtils.cpp.

void CopyLongIntToCStr	(	const long	theNum,
		char *	theCStr,
		const int	maxCStrLength,
		const int	numDigits
	)

Definition at line 711 of file CPStringUtils.cpp.

OSErr CopyLongIntToExistingHandle	(	const long	inTheLongInt,
		Handle	theHandle
	)

Definition at line 831 of file CPStringUtils.cpp.

OSErr CopyLongIntToNewHandle	(	const long	inTheLongInt,
		Handle *	theHandle
	)

Definition at line 817 of file CPStringUtils.cpp.

void CopyLongIntToPStr	(	const long	theNum,
		unsigned char *	thePStr,
		const int	maxPStrLength,
		const int	numDigits
	)

Definition at line 805 of file CPStringUtils.cpp.

void CopyPStrToCStr	(	const unsigned char *	thePStr,
		char *	theCStr,
		const int	maxCStrLength
	)

Definition at line 69 of file CPStringUtils.cpp.

OSErr CopyPStrToNewHandle	(	const unsigned char *	thePString,
		Handle *	theHandle
	)

Definition at line 930 of file CPStringUtils.cpp.

void CopyPStrToPStr	(	const unsigned char *	theSrcPStr,
		unsigned char *	theDstPStr,
		const int	maxDstStrLength
	)

Definition at line 96 of file CPStringUtils.cpp.

void CopyUnsignedLongIntToCStr	(	const unsigned long	theNum,
		char *	theCStr,
		const int	maxCStrLength
	)

Definition at line 751 of file CPStringUtils.cpp.

OSErr CountDigits	(	const char *	inCStr,
		int *	outNumIntegerDigits,
		int *	outNumFractDigits
	)

Definition at line 2105 of file CPStringUtils.cpp.

int CountOccurencesOfCharInCStr	(	const char	inChar,
		const char *	inSrcCStr
	)

Definition at line 2232 of file CPStringUtils.cpp.

int CountWordsInCStr

(

const char *

inSrcCStr

)

Definition at line 2255 of file CPStringUtils.cpp.

long CStrLength

(

const char *

theCString

)

Definition at line 1175 of file CPStringUtils.cpp.

Boolean CStrsAreEqual	(	const char *	theFirstCStr,
		const char *	theSecondCStr,
		const Boolean	ignoreCase
	)

Definition at line 502 of file CPStringUtils.cpp.

void ExtractCStrItemFromCStr	(	const char *	inSrcCStr,
		const char	inItemDelimiter,
		const int	inItemNumber,
		Boolean *	foundItem,
		char *	outDstCharPtr,
		const int	inDstCharPtrMaxLength,
		const Boolean	inTreatMultipleDelimsAsSingleDelim
	)

Definition at line 2320 of file CPStringUtils.cpp.

OSErr ExtractCStrItemFromCStrIntoNewHandle	(	const char *	inSrcCStr,
		const char	inItemDelimiter,
		const int	inItemNumber,
		Boolean *	foundItem,
		Handle *	outNewHandle,
		const Boolean	inTreatMultipleDelimsAsSingleDelim
	)

Definition at line 2397 of file CPStringUtils.cpp.

OSErr ExtractFloatFromCStr	(	const char *	inCString,
		extended80 *	outFloat
	)

Definition at line 2512 of file CPStringUtils.cpp.

OSErr ExtractIntFromCStr	(	const char *	theSrcCStr,
		int *	outInt,
		Boolean	skipLeadingSpaces
	)

Definition at line 2149 of file CPStringUtils.cpp.

OSErr ExtractIntFromPStr	(	const unsigned char *	theSrcPStr,
		int *	outInt,
		Boolean	skipLeadingSpaces
	)

Definition at line 2202 of file CPStringUtils.cpp.

char* FindCharInCStr	(	const char	theChar,
		const char *	theCString
	)

Definition at line 1261 of file CPStringUtils.cpp.

long FindCharOffsetInCStr	(	const char	theChar,
		const char *	theCString,
		const Boolean	inIgnoreCase
	)

Definition at line 1286 of file CPStringUtils.cpp.

long FindCStrOffsetInCStr	(	const char *	theCSubstring,
		const char *	theCString,
		const Boolean	inIgnoreCase
	)

Definition at line 1344 of file CPStringUtils.cpp.

void InsertCStrIntoCStr	(	const char *	theSrcCStr,
		const int	theInsertionOffset,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1404 of file CPStringUtils.cpp.

OSErr InsertCStrIntoHandle	(	const char *	theCString,
		Handle	theHandle,
		const long	inInsertOffset
	)

Definition at line 1510 of file CPStringUtils.cpp.

void InsertPStrIntoCStr	(	const unsigned char *	theSrcPStr,
		const int	theInsertionOffset,
		char *	theDstCStr,
		const int	maxDstStrLength
	)

Definition at line 1457 of file CPStringUtils.cpp.

long PStrLength

(

const unsigned char *

thePString

)

Definition at line 1194 of file CPStringUtils.cpp.

Boolean PStrsAreEqual	(	const unsigned char *	theFirstPStr,
		const unsigned char *	theSecondPStr,
		const Boolean	ignoreCase
	)

Definition at line 516 of file CPStringUtils.cpp.

void SkipWhiteSpace	(	char **	ioSrcCharPtr,
		const Boolean	inStopAtEOL
	)

Definition at line 2733 of file CPStringUtils.cpp.

void ZeroMem	(	void *	theMemPtr,
		const unsigned long	numBytes
	)

Definition at line 1212 of file CPStringUtils.cpp.