Documentation  |   Table of Contents   |  < Previous   |  Next >  

111    StringMgr.h

Porting Applications to Palm OS® Cobalt

Exploring Palm OS®

The only change of note in the String Manager APIs is in the declaration of the StrN... functions: the final parameter that specifies the maximum number of bytes on which to operate changed from an Int32 to a size_t.

Deleted APIs ^TOP^

Table 111.1  Deleted functions

Deleted API

Use instead

StrPrintF()

sprintf(). Note that StringMgr.h contains a #define that maps "StrPrintF" to "sprintf".

StrVPrintF()

vsprintf(). Note that StringMgr.h contains a #define that maps "StrVPrintF" to "vsprintf".

Modified APIs ^TOP^

Table 111.2  Modified functions 

Modified API

Description of change

size_t StrLen (const char *)

This function used to return a UInt16.

int16_t StrNCaselessCompare (const char *, const char *, size_t)

The final parameter, 'n', used to be declared as Int32.

char *StrNCat (char *, const char *, size_t)

The final parameter, 'n', used to be declared as Int32.

int16_t StrNCompare (const char *, const char *, size_t)

The final parameter, 'n', used to be declared as Int32.

int16_t StrNCompareAscii (const char *, const char *, size_t)

The final parameter, 'n', used to be declared as Int32.

char *StrNCopy (char *, const char *, size_t)

The final parameter, 'n', used to be declared as Int32.

Unchanged APIs ^TOP^

Table 111.3  Unchanged functions

StrAToI()

StrCaselessCompare()

StrCat()

StrChr()

StrCompare()

StrCompareAscii()

StrCopy()

StrDelocalizeNumber()

StrIToA()

StrIToH()

StrLocalizeNumber()

StrStr()

StrToLower()

Table 111.4  Unchanged #defines

maxStrIToALen