PrevNextUpHome SophiaFramework UNIVERSE 5.3
SFXHelper
Wrapper class of helper functions.
#include <SFXHelper.h.hpp>
class SFXHelper;
SFMTYPEDEFCLASS(SFXHelper)

Reference

BREW API Helper function

Member

Public Functions
static
SInt32
atoi( ACharConstPtr string )
Convert the input character string into integer.
static
ACharPtr
basename( ACharConstPtr path )
Return the filename component of a path.
static
VoidPtr
compressmem( Void )
Call the COMPRESSMEM() helper function.
static
VoidPtr
convertbmp( VoidPtr address , AEEImageInfo * info , BoolPtr reallocate )
Convert a Windows bitmap into the native format.
static
Void
dbgevent( AEEEvent event , AEECLSID id )
Output the debugging event.
static
Void
dbgevent_ex( AEEEvent event , AEECLSID id , UInt32 payload )
Output the debugging event.
static
VoidPtr
dbgheapmarkex( VoidPtr address , ACharConstPtr file , SInt32 line )
Register the heap in the BREW function of detecting heap memory.
static
Void
dbgprintf( ACharConstPtr format , ... )
Output the debugging information
static
Void
dumpheap( Void )
Output a list of heaps managed by the BREW.
static
SFCError
err_malloc( UIntN size , VoidHandle handle )
The malloc() function that returns the error value.
static
SFCError
err_realloc( UIntN size , VoidHandle handle )
The realloc() function that returns the error value.
static
SFCError
err_strdup( ACharConstPtr string , ACharHandle result )
The strdup() function that returns the error value.
static
Float64
fabs( Float64 value )
Get the absolute value of a floating point value.
static
Float64
fadd( Float64 left , Float64 right )
Perform the floating point "+" operation
static
Float64
fassign_int( SInt32 value )
Return a Float64 with the value specified by the input string.
static
Float64
fassign_str( ACharConstPtr string )
Return a Float64 with the value specified by the input string.
static
Float64
fceil( Float64 value )
Compute the smallest integer value not less than the specified value.
static
Bool
fcmp_e( Float64 left , Float64 right )
Perform float point "==" comparison.
static
Bool
fcmp_g( Float64 left , Float64 right )
Perform the float point ">" comparison.
static
Bool
fcmp_ge( Float64 left , Float64 right )
Perform the float point ">=" comparison.
static
Bool
fcmp_l( Float64 left , Float64 right )
Perform the float point "<" comparison.
static
Bool
fcmp_le( Float64 left , Float64 right )
Perform the float point "<=" comparison.
static
Float64
fcos( Float64 value )
Compute the cosine value of the floating point value.
static
Float64
fdiv( Float64 left , Float64 right )
Perform the floating point "/" operation.
static
Float64
ffloor( Float64 value )
Compute the largest integer value not greater than value.
static
Float64
fgetflt_max( Void )
Return FLT_MAX.
static
Float64
fgetflt_min( Void )
Return FLT_MIN.
static
Float64
fgethuge_val( Void )
Return HUGE_VAL.
static
Bool
floattowstr( Float64 value , WCharPtr destination , UIntN size )
Convert a floating point value into a WChar string.
static
SInt32
flttoint( Float64 value )
Convert a floating point value into integer.
static
Float64
fmul( Float64 left , Float64 right )
Perform the floating point "*" operation.
static
Float64
fpow( Float64 left , Float64 right )
Raise left to the power of right.
static
Void
free( VoidPtr address )
This function is corresponding to the free() function in standard C library.
static
Float64
fsin( Float64 value )
Compute the sine value of the floating point value.
static
Float64
fsqrt( Float64 value )
Compute the square root of the floating point value.
static
Float64
fsub( Float64 left , Float64 right )
Perform the floating point "-" operation.
static
Float64
ftan( Float64 value )
Compute the tangent (tan) of a floating point value.
static
UInt32
getaeeversion( ACharPtr destination , UIntN size , UInt16 flag )
Get information about the version number of the current BREW software being used.
static
SFBQueryPtr
getalscontext( Void )
Return the application local storage context of the currently executing applet.
static
SFCAppletPtr
getappinstance( Void )
Get the SFCApplet instance of the currently executing applet.
static
TChType
getchtype( WChar character )
Get the type (numeric, alpha, etc.) of a wide character.
static
UInt32
getfsfree( UInt32Ptr total )
Get the amount of free file system space on the device.
static
Void
getjuliandate( UInt32 second , JulianType* date )
Get the Julian date structure filled by the input second value.
static
SFCError
getlastfperror( Void )
Get the error set by the last floating point operation.
static
UInt32
getramfree( UInt32Ptr total , UInt32Ptr maximum )
Get the available heap space in bytes.
static
Void
getrand( VoidPtr destination , UIntN size )
Read and get the array of random values using the random number generator of the device.
static
UInt32
gettimems( Void )
Get the number of milliseconds that have elapsed since the last occurrence of 00:00:00 local time.
static
UInt32
gettimeseconds( Void )
Get the number of seconds since 1980/01/06 00:00:00 UTC, including UTC leap second adjustments and adjusted for local time zone and daylight savings time.
static
VoidPtr
gettls( Void )
Get the pre-defined static pointer to a TLS record in BREW.
static
UInt32
getuptimems( Void )
Get the continuously and linearly increasing millisecond timer from the time the device was powered on.
static
UInt32
getutcseconds( Void )
Get the number of seconds since 1980/01/06 00:00:00 UTC.
static
Bool
inet_aton( ACharConstPtr string , INAddr* address )
Convert a string into an InetAddr (unsigned long).
static
Void
inet_ntoa( INAddr address , ACharPtr destination , UIntN size )
Convert an InetAddr (unsigned long) into an ascii string.
static
SIntN
inet_ntop( SIntN family , VoidConstPtr address , ACharPtr destination , UIntN size )
Convert an address structure into a string according to a given address family.
static
SIntN
inet_pton( SIntN family , ACharConstPtr source , VoidPtr address )
Convert a string into an address structure according to a given address family.
static
Bool
isbadreadptr( VoidPtr address , UIntN size )
Call the ISBADREADPTR() helper function.
static
Bool
isbadwriteptr( VoidPtr address , UIntN size )
Call the ISBADWRITEPTR() helper function.
static
UInt32
juliantoseconds( JulianType* date )
Return the number of seconds elapsed since CDMA reference time equivalent of the specified julian date time.
static
SInt32
localtimeoffset( BoolPtr daylight )
Return the local timezone offset from UTC, in seconds.
static
SIntN
lockmem( VoidHandle handle )
Mark a block as locked memory.
static
SFCError
makepath( ACharConstPtr directory , ACharConstPtr file , ACharPtr destination , SInt32Ptr size )
Create a path from a directory name and a file name.
static
VoidPtr
malloc( UIntN size )
This function corresponds to the malloc() function in the standard C library.
static
ACharPtr
memchr( VoidConstPtr address , AChar character , UIntN size )
This function corresponds to the memchr() function in the standard C library.
static
ACharPtr
memchrend( VoidConstPtr address , AChar character , UIntN size )
Find a character in a memory buffer.
static
SInt32
memcmp( VoidConstPtr left , VoidConstPtr right , UIntN size )
This function corresponds to the memcmp() function in the standard C library.
static
VoidPtr
memcpy( VoidPtr destination , VoidConstPtr source , UIntN size )
This function corresponds to the memcpy() function in the standard C library.
static
VoidPtr
memmove( VoidPtr destination , VoidConstPtr source , UIntN size )
This function corresponds to the memmove() function in the standard C library.
static
ACharPtr
memrchr( VoidConstPtr address , AChar character , UIntN size )
Find the last occurence of a character in a buffer.
static
ACharPtr
memrchrbegin( VoidConstPtr address , AChar character , UIntN size )
Find the last occurence of a character in a memory buffer.
static
VoidPtr
memset( VoidPtr destination , UInt08 value , UIntN size )
This function corresponds to the memset() function in the standard C library.
static
ACharPtr
memstr( VoidConstPtr address , ACharConstPtr string , UIntN size )
Find the first occurence of a string in a memory buffer.
static
Void
msleep( UInt32 time )
Suspend the execution of a BREW application for the specified number of milleseconds.
static
SInt32
oemstrlen( ACharConstPtr string )
Return the length of an AChar string.
static
UIntN
oemstrsize( ACharConstPtr string )
Return the size, in bytes, of an AChar string.
static
Void
qsort( VoidPtr base , UIntN length , UIntN size , PFNQSORTCOMPARE comparator )
This function corresponds to the qsort() function in the standard C library.
static
VoidPtr
realloc( VoidPtr address , UIntN size )
This function corresponds to the realloc() function in the standard C library.
static
VoidPtr
setstaticbottom( VoidPtr address )
Set the static pointer defining BREW to the bottom of the stack, set the old value.
static
VoidPtr
setstaticptr( SIntN id , VoidPtr address )
Set a pre-defined static pointer in BREW, set the old value
static
VoidPtr
settls( VoidPtr address )
Get a pre-defined static pointer to a TLS record in BREW, set the old value.
static
SInt32
snprintf( ACharPtr destination , UIntN size , ACharConstPtr format , ... )
This function corresponds to the snprintf() function in the standard C library.
static
ACharPtr
splitpath( ACharConstPtr path , ACharConstPtr directory )
Exclude the specified directory from the specified path.
static
SInt32
sprintf( ACharPtr destination , ACharConstPtr format , ... )
This function corresponds to the sprintf() function in the standard C library.
static
Bool
strbegins( ACharConstPtr prefix , ACharConstPtr string )
Check whether a string starts with a prefix or not.
static
ACharPtr
strcat( ACharPtr destination , ACharConstPtr source )
This function corresponds to the strcat() function in the standard C library.
static
ACharPtr
strchr( ACharConstPtr string , AChar character )
This function corresponds to the strchr() function in the standard C library.
static
ACharPtr
strchrend( ACharConstPtr string , AChar character )
Find the first occurence of a character in a string.
static
ACharPtr
strchrsend( ACharConstPtr string , ACharConstPtr param )
Find the first occurence of a list of characters in a string.
static
SInt32
strcmp( ACharConstPtr left , ACharConstPtr right )
This function corresponds to the strcmp() function in the standard C library.
static
ACharPtr
strcpy( ACharPtr destination , ACharConstPtr source )
This function corresponds to the strcpy() function in the standard C library.
static
ACharPtr
strdup( ACharConstPtr string )
This function corresponds to the strdup() function in the standard C library.
static
Bool
strends( ACharConstPtr suffix , ACharConstPtr string )
Check whether a string ends with a suffix.
static
Void
strexpand( ACharConstPtr source , SInt32 length , WCharPtr destination , UIntN size )
Expand the input string to wide characters
static
Bool
stribegins( ACharConstPtr prefix , ACharConstPtr string )
Check whether or not a string starts with a prefix.
static
SInt32
stricmp( ACharConstPtr left , ACharConstPtr right )
This function corresponds to the strcasecmp(), stricmp(), or strcmpi() function in the standard C library.
static
ACharPtr
stristr( ACharConstPtr string , ACharConstPtr param )
Search for the first occurrence of a string inside another string.
static
SInt32
strlcat( ACharPtr destination , ACharConstPtr source , UIntN size )
Concatenate a string into a destination buffer and guarentee that it is null terminated.
static
SInt32
strlcpy( ACharPtr destination , ACharConstPtr source , UIntN size )
Copy a string into a destination buffer and guarentee that it is null terminated.
static
SInt32
strlen( ACharConstPtr string )
This function corresponds to the strlen() function in the standard C library.
static
ACharPtr
strlower( ACharPtr string )
Convert an AChar string into all small letters.
static
SInt32
strncmp( ACharConstPtr left , ACharConstPtr right , SInt32 length )
This function corresponds to the strncmp() function in the standard C library.
static
ACharPtr
strncpy( ACharPtr destination , ACharConstPtr source , SInt32 length )
This function corresponds to the strncpy() function in the standard C library.
static
SInt32
strnicmp( ACharConstPtr left , ACharConstPtr right , SInt32 length )
This function corresponds to the strncasecmp(), strnicmp(), or strncmpi() function in the standard C library.
static
ACharPtr
strrchr( ACharConstPtr string , AChar character )
This function corresponds to the strrchr() function in the standard C library.
static
ACharPtr
strstr( ACharConstPtr string , ACharConstPtr param )
This function corresponds to the strstr() function in the standard C library.
static
Float64
strtod( ACharConstPtr string , ACharHandle result )
Convert the initial portion of the string into Float64 type.
static
UInt32
strtoul( ACharConstPtr string , ACharHandle result , SInt32 base )
This function corresponds to the strtoul() function in the standard C library.
static
WCharPtr
strtowstr( ACharConstPtr source , WCharPtr destination , UIntN size )
Converts an AChar string into a WChar string.
static
ACharPtr
strupper( ACharPtr string )
Convert a AChar string into capital letters.
static
UInt32
swapl( UInt32 value )
Swap the upper byte and the lower byte of an unsigned long value.
static
UInt16
swaps( UInt16 value )
Swap the upper byte and the lower byte of an unsigned short value.
static
Void
sysfree( VoidPtr address )
Return the memory pointer returned from the CONVERTBMP() function to the system.
static
SInt32
trunc( Float64 value )
Convert a floating point value into signed integer.
static
SIntN
unlockmem( VoidHandle handle )
Mark a block as a memory block that can be moved
static
Bool
utf8towstr( ACharConstPtr source , SInt32 length , WCharPtr destination , UIntN size )
Convert a UTF8 string into a WChar string.
static
UInt32
utrunc( Float64 value )
Convert the floating point value into unsigned integer.
static
SInt32
vsnprintf( ACharPtr destination , UIntN size , ACharConstPtr format , va_list argument )
Write a formatted output to the stream.
static
SInt32
vsprintf( ACharPtr destination , ACharConstPtr format , va_list argument )
This function corresponds to the vsprintf() function in the standard C library.
static
Float64
wgs84_to_degrees( SInt32 value )
Convert latitude or longitude in WGS84 format into Degree decimal format
static
Void
wsprintf( WCharPtr destination , UIntN size , WCharConstPtr format , ... )
Similar to the SPRINTF() function, used for the WChar string.
static
WCharPtr
wstrcat( WCharPtr destination , WCharConstPtr source )
Similar to the STRCAT() function, used for the WChar string.
static
WCharPtr
wstrchr( WCharConstPtr string , WChar character )
Similar to the STRCHR() function, used for the WChar string.
static
SInt32
wstrcmp( WCharConstPtr left , WCharConstPtr right )
Similar to the STRCMP() function, used for the WChar string.
static
Void
wstrcompress( WCharConstPtr source , SInt32 length , ACharPtr destination , UIntN size )
Compress the input WChar string.
static
WCharPtr
wstrcpy( WCharPtr destination , WCharConstPtr source )
Similar to the STRCPY() function, used for the WChar string.
static
WCharPtr
wstrdup( WCharConstPtr string )
Similar to the STRDUP() function, used for the WChar string.
static
SInt32
wstricmp( WCharConstPtr left , WCharConstPtr right )
Similar to the STRICMP() function, used for the WChar string.
static
SInt32
wstrlcat( WCharPtr destination , WCharConstPtr source , SInt32 size )
Similar to the STRLCAT() function, used for the WChar string.
static
SInt32
wstrlcpy( WCharPtr destination , WCharConstPtr source , SInt32 size )
Similar to the STRLCPY() function, used for the WChar string.
static
SInt32
wstrlen( WCharConstPtr string )
Similar to the STRLEN() function, used for the WChar string.
static
Void
wstrlower( WCharPtr string )
Similar to the STRLOWER() function, used for the WChar string.
static
SInt32
wstrncmp( WCharConstPtr left , WCharConstPtr right , SInt32 length )
Similar to the STRNCMP() function, used for the WChar string.
static
SInt32
wstrncopyn( WCharPtr destination , SInt32 size , WCharConstPtr source , SInt32 length )
Copy specified length of the source string into destination.
static
SInt32
wstrnicmp( WCharConstPtr left , WCharConstPtr right , SInt32 length )
Similar to the STRNICMP() function, used for the WChar string.
static
WCharPtr
wstrrchr( WCharConstPtr string , WChar character )
Similar to the STRRCHR() function, used for the WChar string.
static
UIntN
wstrsize( WCharConstPtr string )
Return the size, in bytes, of a WChar string.
static
Float64
wstrtofloat( WCharConstPtr string )
Convert a WChar string into a floating point value.
static
ACharPtr
wstrtostr( WCharConstPtr source , ACharPtr destination , UIntN size )
Convert a WChar string into an AChar string.
static
Bool
wstrtoutf8( WCharConstPtr source , SInt32 length , ACharPtr destination , UIntN size )
Convert a WChar string to UTF8 string.
static
Void
wstrupper( WCharPtr string )
Similar to the STRUPPER() function, used for the WChar string.
static
WCharPtr
wwritelong( WCharPtr destination , SInt32 value )
Write a decimal value as zero-terminated string.
static
WCharPtr
wwritelongex( WCharPtr destination , SInt32 value , SInt32 padding , SInt32Ptr result )
Convert long type into WChar string.

SFXHelper::atoi
Convert the input character string into integer.
[ public, static ]
SInt32 atoi(
    ACharConstPtr string   // pointer to source character string
);

Reference

BREW API ATOI


SFXHelper::basename
Return the filename component of a path.
[ public, static ]
ACharPtr basename(
    ACharConstPtr path   
);

Description

Create a path from a directory name and a file name.

The SFXHelper::basename function can be used for BREW SDK version 3.1 or later.

Reference

BREW API BASENAME


SFXHelper::compressmem
Call the COMPRESSMEM() helper function.
[ public, static ]
VoidPtr compressmem(Void);

Description

The SFXHelper::compressmem function can be used for BREW SDK version 2.1 or earlier.

Reference

BREW API COMPRESSMEM


SFXHelper::convertbmp
Convert a Windows bitmap into the native format.
[ public, static ]
VoidPtr convertbmp(
    VoidPtr address       // pointer to a buffer containing the Windows bitmap
    AEEImageInfo * info   // image's information after conversion
    BoolPtr reallocate    // whether this function separate the allocated memory or not
);

Reference

BREW API CONVERTBMP


SFXHelper::dbgevent
Output the debugging event.
[ public, static ]
Void dbgevent(
    AEEEvent event   // event
    AEECLSID id      // ClassID
);

Description

The SFXHelper::dbgevent function can be used for BREW SDK version 3.1 or later.

Reference

BREW API DBGEVENT


SFXHelper::dbgevent_ex
Output the debugging event.
[ public, static ]
Void dbgevent_ex(
    AEEEvent event   // event
    AEECLSID id      // ClassID
    UInt32 payload   // user defined payload
);

Description

The SFXHelper::dbgevent_ex function can be used for BREW SDK version 3.1 or later.

Reference

BREW API DBGEVENT_EX


SFXHelper::dbgheapmarkex
Register the heap in the BREW function of detecting heap memory.
[ public, static ]
VoidPtr dbgheapmarkex(
    VoidPtr address      // address of the heap to be registered
    ACharConstPtr file   // file name
    SInt32 line          // line number
);

SFXHelper::dbgprintf
Output the debugging information
[ public, static ]
Void dbgprintf(
    ACharConstPtr format   // format control string
    ...                    // optional argument
);

Reference

BREW API DBGPRINTF


SFXHelper::dumpheap
Output a list of heaps managed by the BREW.
[ public, static ]
Void dumpheap(Void);

SFXHelper::err_malloc
The malloc() function that returns the error value.
[ public, static ]
SFCError err_malloc(
    UIntN size          // buffer size (in bytes)
    VoidHandle handle   // allocated buffer handle
);

Return value

  • If succeeds: SFERR_NO_ERROR
  • If failed : error value defined in AEEError.h

Description

The SFXHelper::err_malloc function does not initialize the allocated memory.

The SFXHelper::err_malloc function can be used for BREW SDK version 3.1 or later.

Reference

BREW API ERR_MALLOC


SFXHelper::err_realloc
The realloc() function that returns the error value.
[ public, static ]
SFCError err_realloc(
    UIntN size          // buffer size (in bytes)
    VoidHandle handle   // allocated buffer handle
);

Return value

  • If succeeds: SFERR_NO_ERROR
  • If failed : error value defined in AEEError.h

Description

The SFXHelper::err_realloc function does not initialize the allocated memory.

The SFXHelper::err_realloc function can be used for BREW SDK version 3.1 or later.

Reference

BREW API ERR_REALLOC


SFXHelper::err_strdup
The strdup() function that returns the error value.
[ public, static ]
SFCError err_strdup(
    ACharConstPtr string   // character string to be duplicated
    ACharHandle result     // handle to the result
);

Return value

  • If succeeds: SFERR_NO_ERROR
  • If failed : error value defined in AEEError.h

Description

The SFXHelper::err_strdup function can be used for BREW SDK version 3.1 or later.

Reference

BREW API ERR_STRDUP


SFXHelper::fabs
Get the absolute value of a floating point value.
[ public, static ]
Float64 fabs(
    Float64 value   
);

Description

The SFXHelper::fabs function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FABS


SFXHelper::fadd
Perform the floating point "+" operation
[ public, static ]
Float64 fadd(
    Float64 left    
    Float64 right   
);

Reference

BREW API FADD


SFXHelper::fassign_int
Return a Float64 with the value specified by the input string.
[ public, static ]
Float64 fassign_int(
    SInt32 value   // value to be assigned to the Float64 returned
);

Reference

BREW API FASSIGN_INT


SFXHelper::fassign_str
Return a Float64 with the value specified by the input string.
[ public, static ]
Float64 fassign_str(
    ACharConstPtr string   // string containing the value to be assigned
);

Reference

BREW API FASSIGN_STR


SFXHelper::fceil
Compute the smallest integer value not less than the specified value.
[ public, static ]
Float64 fceil(
    Float64 value   
);

Description

The SFXHelper::fceil function can be used for BREW SDK version 2.1 or later.

Reference

BREW API FCEIL


SFXHelper::fcmp_e
Perform float point "==" comparison.
[ public, static ]
Bool fcmp_e(
    Float64 left    
    Float64 right   
);

Reference

BREW API FCMP_E


SFXHelper::fcmp_g
Perform the float point ">" comparison.
[ public, static ]
Bool fcmp_g(
    Float64 left    
    Float64 right   
);

Reference

BREW API FCMP_G


SFXHelper::fcmp_ge
Perform the float point ">=" comparison.
[ public, static ]
Bool fcmp_ge(
    Float64 left    
    Float64 right   
);

Reference

BREW API FCMP_GE


SFXHelper::fcmp_l
Perform the float point "<" comparison.
[ public, static ]
Bool fcmp_l(
    Float64 left    
    Float64 right   
);

Reference

BREW API FCMP_L


SFXHelper::fcmp_le
Perform the float point "<=" comparison.
[ public, static ]
Bool fcmp_le(
    Float64 left    
    Float64 right   
);

Reference

BREW API FCMP_LE


SFXHelper::fcos
Compute the cosine value of the floating point value.
[ public, static ]
Float64 fcos(
    Float64 value   
);

Description

The SFXHelper::fcos function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FCOS


SFXHelper::fdiv
Perform the floating point "/" operation.
[ public, static ]
Float64 fdiv(
    Float64 left    
    Float64 right   
);

Reference

BREW API FDIV


SFXHelper::ffloor
Compute the largest integer value not greater than value.
[ public, static ]
Float64 ffloor(
    Float64 value   
);

Description

The SFXHelper::ffloor function can be used for BREW SDK version 2.1 or later.

Reference

BREW API FFLOOR


SFXHelper::fgetflt_max
Return FLT_MAX.
[ public, static ]
Float64 fgetflt_max(Void);

Description

The SFXHelper::fgetflt_max function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FGETFLT_MAX


SFXHelper::fgetflt_min
Return FLT_MIN.
[ public, static ]
Float64 fgetflt_min(Void);

Description

The SFXHelper::fgetflt_min function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FGETFLT_MIN


SFXHelper::fgethuge_val
Return HUGE_VAL.
[ public, static ]
Float64 fgethuge_val(Void);

Description

The SFXHelper::fgethuge_val function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FGETHUGE_VAL


SFXHelper::floattowstr
Convert a floating point value into a WChar string.
[ public, static ]
Bool floattowstr(
    Float64 value          // floating point value to be converted into a WChar string
    WCharPtr destination   // pointer to WChar  buffer to hold the resultant WChar string
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API FLOATTOWSTR


SFXHelper::flttoint
Convert a floating point value into integer.
[ public, static ]
SInt32 flttoint(
    Float64 value   
);

Description

The SFXHelper::flttoint function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FLTTOINT


SFXHelper::fmul
Perform the floating point "*" operation.
[ public, static ]
Float64 fmul(
    Float64 left    
    Float64 right   
);

Reference

BREW API FMUL


SFXHelper::fpow
Raise left to the power of right.
[ public, static ]
Float64 fpow(
    Float64 left    
    Float64 right   
);

Description

The SFXHelper::fpow function can be used for BREW SDK version 2.1 or later.

Reference

BREW API FPOW


SFXHelper::free
This function is corresponding to the free() function in standard C library.
[ public, static ]
Void free(
    VoidPtr address   // pointer to the memory to be freed
);

Reference

BREW API FREE


SFXHelper::fsin
Compute the sine value of the floating point value.
[ public, static ]
Float64 fsin(
    Float64 value   
);

Description

The SFXHelper::fsin function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FSIN


SFXHelper::fsqrt
Compute the square root of the floating point value.
[ public, static ]
Float64 fsqrt(
    Float64 value   
);

Description

The SFXHelper::fsqrt function can be used for BREW SDK version 2.1 or later.

Reference

BREW API FSQRT


SFXHelper::fsub
Perform the floating point "-" operation.
[ public, static ]
Float64 fsub(
    Float64 left    
    Float64 right   
);

Reference

BREW API FSUB


SFXHelper::ftan
Compute the tangent (tan) of a floating point value.
[ public, static ]
Float64 ftan(
    Float64 value   
);

Description

The SFXHelper::ftan function can be used for BREW SDK version 3.1 or later.

Reference

BREW API FTAN


SFXHelper::getaeeversion
Get information about the version number of the current BREW software being used.
[ public, static ]
UInt32 getaeeversion(
    ACharPtr destination   // pointer to a buffer where the string containing the version number will be placed
    UIntN size             // size of the destination buffer (in bytes)
    UInt16 flag            // type of information to get
);

Reference

BREW API GETAEEVERSION


SFXHelper::getalscontext
Return the application local storage context of the currently executing applet.
[ public, static ]
SFBQueryPtr getalscontext(Void);

Description

The SFXHelper::getalscontext function can be used for BREW SDK version 4.0 or later.

Reference

BREW API getalscontext


SFXHelper::getappinstance
Get the SFCApplet instance of the currently executing applet.
[ public, static ]
SFCAppletPtr getappinstance(Void);

Reference

BREW API GETAPPINSTANCE


SFXHelper::getchtype
Get the type (numeric, alpha, etc.) of a wide character.
[ public, static ]
TChType getchtype(
    WChar character   // character whose type is to be determined
);

Reference

BREW API GETCHTYPE


SFXHelper::getfsfree
Get the amount of free file system space on the device.
[ public, static ]
UInt32 getfsfree(
    UInt32Ptr total   // pointer to the total file system space on the device (in bytes)
);

Reference

BREW API GETFSFREE


SFXHelper::getjuliandate
Get the Julian date structure filled by the input second value.
[ public, static ]
Void getjuliandate(
    UInt32 second      // number of seconds from January 6, 1980
    JulianType* date   // pointer to the structure that needs to be filled on returned
);

Reference

BREW API GETJULIANDATE


SFXHelper::getlastfperror
Get the error set by the last floating point operation.
[ public, static ]
SFCError getlastfperror(Void);

Return value

  • If succeeds: SFERR_NO_ERROR
  • If failed : error value defined in AEEError.h

Description

The SFXHelper::getlastfperror function can be used for BREW SDK version 2.1 or later.

Reference

BREW API GETLASTFPERROR


SFXHelper::getramfree
Get the available heap space in bytes.
[ public, static ]
UInt32 getramfree(
    UInt32Ptr total     // pointer to system's total memory value
    UInt32Ptr maximum   // pointer to the size of largest node that can currently be allocated
);

Reference

BREW API GETRAMFREE


SFXHelper::getrand
Read and get the array of random values using the random number generator of the device.
[ public, static ]
Void getrand(
    VoidPtr destination   // pointer to the destination buffer
    UIntN size            // buffer size (in bytes)
);

Reference

BREW API GETRAND


SFXHelper::gettimems
Get the number of milliseconds that have elapsed since the last occurrence of 00:00:00 local time.
[ public, static ]
UInt32 gettimems(Void);

Reference

BREW API GETTIMEMS


SFXHelper::gettimeseconds
Get the number of seconds since 1980/01/06 00:00:00 UTC, including UTC leap second adjustments and adjusted for local time zone and daylight savings time.
[ public, static ]
UInt32 gettimeseconds(Void);

Reference

BREW API GETTIMESECONDS


SFXHelper::gettls
Get the pre-defined static pointer to a TLS record in BREW.
[ public, static ]
VoidPtr gettls(Void);

Reference

BREW API GETTLS


SFXHelper::getuptimems
Get the continuously and linearly increasing millisecond timer from the time the device was powered on.
[ public, static ]
UInt32 getuptimems(Void);

Reference

BREW API GETUPTIMEMS


SFXHelper::getutcseconds
Get the number of seconds since 1980/01/06 00:00:00 UTC.
[ public, static ]
UInt32 getutcseconds(Void);

Description

Return the number of seconds since 1980/01/06 00:00:00 UTC.

The SFXHelper::getutcseconds functon can be used for BREW SDK version 3.1 or later.

Reference

BREW API GETUTCSECONDS


SFXHelper::inet_aton
Convert a string into an InetAddr (unsigned long).
[ public, static ]
Bool inet_aton(
    ACharConstPtr string   // string containing the addr (like "1.2.3.4")
    INAddr* address        // pointer to the inet address to be obtained
);

Reference

BREW API INET_ATON


SFXHelper::inet_ntoa
Convert an InetAddr (unsigned long) into an ascii string.
[ public, static ]
Void inet_ntoa(
    INAddr address         // the inet address to be converted
    ACharPtr destination   // buffer to write into
    UIntN size             // size of the destination
);

Reference

BREW API INET_NTOA


SFXHelper::inet_ntop
Convert an address structure into a string according to a given address family.
[ public, static ]
SIntN inet_ntop(
    SIntN family           // the address family of the address structure that will be converted
    VoidConstPtr address   // pointer to the address structure to be converted
    ACharPtr destination   // buffer to write the string into
    UIntN size             // size of the buffer pointed to by destination
);

Description

The inet_ntop function can be used for BREW SDK version 4.0 or later

Reference

BREW API inet_ntop


SFXHelper::inet_pton
Convert a string into an address structure according to a given address family.
[ public, static ]
SIntN inet_pton(
    SIntN family           // the address family of the string that will be converted
    ACharConstPtr source   // string containing the address, it can contain either IPv4 or IPv6 address
    VoidPtr address        // pointer to an address structure that will be filled with the address
);

Description

The inet_pton function can be used for BREW SDK version 4.0 or later.

Reference

BREW API inet_pton


SFXHelper::isbadreadptr
Call the ISBADREADPTR() helper function.
[ public, static ]
Bool isbadreadptr(
    VoidPtr address   // pointer to the buffer which needs to be verified for read access
    UIntN size        // buffer size
);

Return value

  • If buffer is readable: false
  • Otherwise: true

Description

Check whether or not the buffer address of length size is readable by the caller.

The SFXHelper::isbadreadptr function can be used for BREW SDK version 3.1 or later.

Reference

BREW API ISBADREADPTR


SFXHelper::isbadwriteptr
Call the ISBADWRITEPTR() helper function.
[ public, static ]
Bool isbadwriteptr(
    VoidPtr address   // pointer to the buffer which needs to be verified for write access
    UIntN size        // buffer size
);

Return value

  • If buffer is readable: false
  • Otherwise: true

Description

Check whether or not the buffer address of length size is writable by the caller.

The SFXHelper::isbadwriteptr function can be used for BREW SDK version 3.1 or later.

Reference

BREW API ISBADWRITEPTR


SFXHelper::juliantoseconds
Return the number of seconds elapsed since CDMA reference time equivalent of the specified julian date time.
[ public, static ]
UInt32 juliantoseconds(
    JulianType* date   // pointer to julian date time structure
);

Reference

BREW API JULIANTOSECONDS


SFXHelper::localtimeoffset
Return the local timezone offset from UTC, in seconds.
[ public, static ]
SInt32 localtimeoffset(
    BoolPtr daylight   // if not null, this flag specifies whether or not Daylight Savings time is active.
);

Reference

BREW API LOCALTIMEOFFSET


SFXHelper::lockmem
Mark a block as locked memory.
[ public, static ]
SIntN lockmem(
    VoidHandle handle   // pointer to the handle of allocated memory
);

Reference

BREW API LOCKMEM


SFXHelper::makepath
Create a path from a directory name and a file name.
[ public, static ]
SFCError makepath(
    ACharConstPtr directory   // directory
    ACharConstPtr file        // file part of the path
    ACharPtr destination      // destination buffer to write the path to
    SInt32Ptr size            // size of the destination
);

Argument

directory

The null terminated directory.

file

File part of the path.

destination

Destination buffer to write the path to, may be null.

On input: size of the destination. On output: number of bytes written to destination (including null-termination). if destination is null: number of bytes needed to make the path.

Return value

  • If succeeds: SFERR_NO_ERROR
  • If failed : error value defined in AEEError.h

Description

The SFXHelper::makepath function can be used for BREW SDK version 3.1 or later.

Reference

BREW API MAKEPATH


SFXHelper::malloc
This function corresponds to the malloc() function in the standard C library.
[ public, static ]
VoidPtr malloc(
    UIntN size   // buffer size (in bytes)
);

Description

The SFXHelper::malloc function does not initialize the allocated memory.

Reference

BREW API MALLOC


SFXHelper::memchr
This function corresponds to the memchr() function in the standard C library.
[ public, static ]
ACharPtr memchr(
    VoidConstPtr address   // memory to search
    AChar character        // character to be located
    UIntN size             // size of address
);

Reference

BREW API MEMCHR


SFXHelper::memchrend
Find a character in a memory buffer.
[ public, static ]
ACharPtr memchrend(
    VoidConstPtr address   // memory to search
    AChar character        // character to be located
    UIntN size             // size of address
);

Reference

BREW API MEMCHREND


SFXHelper::memcmp
This function corresponds to the memcmp() function in the standard C library.
[ public, static ]
SInt32 memcmp(
    VoidConstPtr left    // pointer to memory buffer to be compared
    VoidConstPtr right   // pointer to memory buffer to be compared
    UIntN size           // number of bytes that must be compared
);

Reference

BREW API MEMCMP


SFXHelper::memcpy
This function corresponds to the memcpy() function in the standard C library.
[ public, static ]
VoidPtr memcpy(
    VoidPtr destination   // pointer to the destination buffer
    VoidConstPtr source   // pointer to source buffer
    UIntN size            // specifies the number of bytes that must be coped from src to dest
);

Reference

BREW API MEMCPY


SFXHelper::memmove
This function corresponds to the memmove() function in the standard C library.
[ public, static ]
VoidPtr memmove(
    VoidPtr destination   // pointer to the destination buffer
    VoidConstPtr source   // pointer to source buffer
    UIntN size            // specifies the number of bytes that must be coped from src to dest
);

Reference

BREW API MEMMOVE


SFXHelper::memrchr
Find the last occurence of a character in a buffer.
[ public, static ]
ACharPtr memrchr(
    VoidConstPtr address   // memory to search
    AChar character        // character to be located
    UIntN size             // size of address
);

Reference

BREW API MEMRCHR


SFXHelper::memrchrbegin
Find the last occurence of a character in a memory buffer.
[ public, static ]
ACharPtr memrchrbegin(
    VoidConstPtr address   // memory to search
    AChar character        // character to be located
    UIntN size             // size of address
);

Reference

BREW API MEMRCHRBEGIN


SFXHelper::memset
This function corresponds to the memset() function in the standard C library.
[ public, static ]
VoidPtr memset(
    VoidPtr destination   // pointer to the destination buffer
    UInt08 value          // specify the value that must be copied into the destination buffer
    UIntN size            // specify the number of bytes in dest that must be set to value
);

Reference

BREW API MEMSET


SFXHelper::memstr
Find the first occurence of a string in a memory buffer.
[ public, static ]
ACharPtr memstr(
    VoidConstPtr address   // memory to search
    ACharConstPtr string   // character string to search for
    UIntN size             // size of address
);

Reference

BREW API MEMSTR


SFXHelper::msleep
Suspend the execution of a BREW application for the specified number of milleseconds.
[ public, static ]
Void msleep(
    UInt32 time   // sleep duration (in milleseconds)
);

Description

The SFXHelper::msleep function can be used for BREW SDK version 2.1 or later.

Reference

BREW API MSLEEP


SFXHelper::oemstrlen
Return the length of an AChar string.
[ public, static ]
SInt32 oemstrlen(
    ACharConstPtr string   // valid pointer to a null-terminated AChar string
);

Reference

BREW API OEMSTRLEN


SFXHelper::oemstrsize
Return the size, in bytes, of an AChar string.
[ public, static ]
UIntN oemstrsize(
    ACharConstPtr string   // valid pointer to a null-terminated AChar string
);

Reference

BREW API OEMSTRSIZE


SFXHelper::qsort
This function corresponds to the qsort() function in the standard C library.
[ public, static ]
Void qsort(
    VoidPtr base                 
    UIntN length                 
    UIntN size                   
    PFNQSORTCOMPARE comparator   
);

Description

The SFXHelper::qsort function can be used for BREW SDK version 3.1 or later.

Reference

BREW API QSORT


SFXHelper::realloc
This function corresponds to the realloc() function in the standard C library.
[ public, static ]
VoidPtr realloc(
    VoidPtr address   // pointer to the previously allocated memory
    UIntN size        // new size (in bytes)
);

Description

The memory allocated by the SFXHelper::realloc function is not initialized.

Reference

BREW API REALLOC


SFXHelper::setstaticbottom
Set the static pointer defining BREW to the bottom of the stack, set the old value.
[ public, static ]
VoidPtr setstaticbottom(
    VoidPtr address   // new value
);

Reference

BREW API SETSTATICBOTTOM


SFXHelper::setstaticptr
Set a pre-defined static pointer in BREW, set the old value
[ public, static ]
VoidPtr setstaticptr(
    SIntN id          // ID of the static pointer
    VoidPtr address   // new value
);

Reference

BREW API SETSTATICPTR


SFXHelper::settls
Get a pre-defined static pointer to a TLS record in BREW, set the old value.
[ public, static ]
VoidPtr settls(
    VoidPtr address   // new value
);

Reference

BREW API SETTLS


SFXHelper::snprintf
This function corresponds to the snprintf() function in the standard C library.
[ public, static ]
SInt32 snprintf(
    ACharPtr destination   // to store output
    UIntN size             // maximum number of characters
    ACharConstPtr format   // format control string
    ...                    // optional argument
);

SFXHelper::splitpath
Exclude the specified directory from the specified path.
[ public, static ]
ACharPtr splitpath(
    ACharConstPtr path        // path
    ACharConstPtr directory   // directory
);

Description

The SFXHelper::splitpath function can be used for BREW SDK version 3.1 or later.

Reference

BREW API SPLITPATH


SFXHelper::sprintf
This function corresponds to the sprintf() function in the standard C library.
[ public, static ]
SInt32 sprintf(
    ACharPtr destination   // to store output
    ACharConstPtr format   // format control string
    ...                    // optional argument
);

Reference

BREW API SPRINTF


SFXHelper::strbegins
Check whether a string starts with a prefix or not.
[ public, static ]
Bool strbegins(
    ACharConstPtr prefix   // prefix to test for
    ACharConstPtr string   // string to be checked
);

Reference

BREW API STRBEGINS


SFXHelper::strcat
This function corresponds to the strcat() function in the standard C library.
[ public, static ]
ACharPtr strcat(
    ACharPtr destination   // pointer to the NULL terminated destination string
    ACharConstPtr source   // pointer to the NULL terminated source string
);

Reference

BREW API STRCAT


SFXHelper::strchr
This function corresponds to the strchr() function in the standard C library.
[ public, static ]
ACharPtr strchr(
    ACharConstPtr string   // null terminated WChar string to search
    AChar character        // character to be located
);

Reference

BREW API STRCHR


SFXHelper::strchrend
Find the first occurence of a character in a string.
[ public, static ]
ACharPtr strchrend(
    ACharConstPtr string   // null terminated WChar string to search
    AChar character        // character to be located
);

Reference

BREW API STRCHREND


SFXHelper::strchrsend
Find the first occurence of a list of characters in a string.
[ public, static ]
ACharPtr strchrsend(
    ACharConstPtr string   // null terminated WChar string to search
    ACharConstPtr param    // null terminated string of characters to find
);

Reference

BREW API STRCHRSEND


SFXHelper::strcmp
This function corresponds to the strcmp() function in the standard C library.
[ public, static ]
SInt32 strcmp(
    ACharConstPtr left    // pointer to the null terminated string to be compared
    ACharConstPtr right   // pointer to the null terminated string to be compared
);

Reference

BREW API STRCMP


SFXHelper::strcpy
This function corresponds to the strcpy() function in the standard C library.
[ public, static ]
ACharPtr strcpy(
    ACharPtr destination   // pointer to destination string
    ACharConstPtr source   // pointer to source character string
);

Reference

BREW API STRCPY


SFXHelper::strdup
This function corresponds to the strdup() function in the standard C library.
[ public, static ]
ACharPtr strdup(
    ACharConstPtr string   // string to be copied
);

Reference

BREW API STRDUP


SFXHelper::strends
Check whether a string ends with a suffix.
[ public, static ]
Bool strends(
    ACharConstPtr suffix   // suffix to test for
    ACharConstPtr string   // string to be checked
);

Reference

BREW API STRENDS


SFXHelper::strexpand
Expand the input string to wide characters
[ public, static ]
Void strexpand(
    ACharConstPtr source   // source character string ended by null
    SInt32 length          // source string length (number of characters)
    WCharPtr destination   // pointer to the destination buffer
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API STREXPAND


SFXHelper::stribegins
Check whether or not a string starts with a prefix.
[ public, static ]
Bool stribegins(
    ACharConstPtr prefix   // prefix
    ACharConstPtr string   // string to be checked
);

Description

The SFXHelper::stribegins function is case-insensitive.

Reference

BREW API STRIBEGINS


SFXHelper::stricmp
This function corresponds to the strcasecmp(), stricmp(), or strcmpi() function in the standard C library.
[ public, static ]
SInt32 stricmp(
    ACharConstPtr left    // pointer to the null terminated string to be compared
    ACharConstPtr right   // pointer to the null terminated string to be compared
);

Reference

BREW API STRICMP


SFXHelper::stristr
Search for the first occurrence of a string inside another string.
[ public, static ]
ACharPtr stristr(
    ACharConstPtr string   // character string to be searched
    ACharConstPtr param    // character string to search for
);

Description

This function is case-insensitive.

Reference

BREW API STRISTR


SFXHelper::strlcat
Concatenate a string into a destination buffer and guarentee that it is null terminated.
[ public, static ]
SInt32 strlcat(
    ACharPtr destination   // destination string. String to concatenate into
    ACharConstPtr source   // source string. string to copy from
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API STRLCAT


SFXHelper::strlcpy
Copy a string into a destination buffer and guarentee that it is null terminated.
[ public, static ]
SInt32 strlcpy(
    ACharPtr destination   // destination string. string to copy into.
    ACharConstPtr source   // source string. string to copy from
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API STRLCPY


SFXHelper::strlen
This function corresponds to the strlen() function in the standard C library.
[ public, static ]
SInt32 strlen(
    ACharConstPtr string   // null terminated string whose length is to be determined
);

Reference

BREW API STRLEN


SFXHelper::strlower
Convert an AChar string into all small letters.
[ public, static ]
ACharPtr strlower(
    ACharPtr string   // string to be converted into small letters
);

Reference

BREW API STRLOWER


SFXHelper::strncmp
This function corresponds to the strncmp() function in the standard C library.
[ public, static ]
SInt32 strncmp(
    ACharConstPtr left    // pointer to the null terminated string to be compared
    ACharConstPtr right   // pointer to the null terminated string to be compared
    SInt32 length         // maximum bytes to be compared
);

Reference

BREW API STRNCMP


SFXHelper::strncpy
This function corresponds to the strncpy() function in the standard C library.
[ public, static ]
ACharPtr strncpy(
    ACharPtr destination   // destination string
    ACharConstPtr source   // source string
    SInt32 length          // number of characters to be copied
);

Reference

BREW API STRNCPY


SFXHelper::strnicmp
This function corresponds to the strncasecmp(), strnicmp(), or strncmpi() function in the standard C library.
[ public, static ]
SInt32 strnicmp(
    ACharConstPtr left    // pointer to the null terminated string to be compared
    ACharConstPtr right   // pointer to the null terminated string to be compared
    SInt32 length         // maximum bytes to be compared
);

Reference

BREW API STRNICMP


SFXHelper::strrchr
This function corresponds to the strrchr() function in the standard C library.
[ public, static ]
ACharPtr strrchr(
    ACharConstPtr string   // null terminated WChar string to search
    AChar character        // character to be located
);

Reference

BREW API STRRCHR


SFXHelper::strstr
This function corresponds to the strstr() function in the standard C library.
[ public, static ]
ACharPtr strstr(
    ACharConstPtr string   // character string to be searched
    ACharConstPtr param    // character string to search for
);

Reference

BREW API STRSTR


SFXHelper::strtod
Convert the initial portion of the string into Float64 type.
[ public, static ]
Float64 strtod(
    ACharConstPtr string   // null terminated string to be converted
    ACharHandle result     // pointer to character that stops the conversion
);

Description

The SFXHelper::strtod function can be used for BREW SDK version 2.1 or later.

Reference

BREW API STRTOD


SFXHelper::strtoul
This function corresponds to the strtoul() function in the standard C library.
[ public, static ]
UInt32 strtoul(
    ACharConstPtr string   // null terminated string to be converted
    ACharHandle result     // If not null, it points to character that stops scan on return
    SInt32 base            // number base to use
);

Reference

BREW API STRTOUL


SFXHelper::strtowstr
Converts an AChar string into a WChar string.
[ public, static ]
WCharPtr strtowstr(
    ACharConstPtr source   // pointer to null terminated string comprised of single-byte characters
    WCharPtr destination   // pointer to destination buffer to store the WChar string
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API STRTOWSTR


SFXHelper::strupper
Convert a AChar string into capital letters.
[ public, static ]
ACharPtr strupper(
    ACharPtr string   // string to be converted into capital letter
);

Reference

BREW API STRUPPER


SFXHelper::swapl
Swap the upper byte and the lower byte of an unsigned long value.
[ public, static ]
UInt32 swapl(
    UInt32 value   // value to be swap
);

SFXHelper::swaps
Swap the upper byte and the lower byte of an unsigned short value.
[ public, static ]
UInt16 swaps(
    UInt16 value   // value to be swap
);

SFXHelper::sysfree
Return the memory pointer returned from the CONVERTBMP() function to the system.
[ public, static ]
Void sysfree(
    VoidPtr address   // pointer to memory allocated by CONVERTBMP
);

Reference

BREW API SYSFREE


SFXHelper::trunc
Convert a floating point value into signed integer.
[ public, static ]
SInt32 trunc(
    Float64 value   
);

Description

Truncating any fractional part.

The SFXHelper::trunc function can be used for BREW SDK version 3.1 or later.

Reference

BREW API TRUNC


SFXHelper::unlockmem
Mark a block as a memory block that can be moved
[ public, static ]
SIntN unlockmem(
    VoidHandle handle   // pointer to the handle of allocated memory
);

Reference

BREW API UNLOCKMEM


SFXHelper::utf8towstr
Convert a UTF8 string into a WChar string.
[ public, static ]
Bool utf8towstr(
    ACharConstPtr source   // pointer to null terminated input string
    SInt32 length          // length of input string (in bytes)
    WCharPtr destination   // destination string
    UIntN size             // size of destination (in bytes)
);

Reference

BREW API UTF8TOWSTR


SFXHelper::utrunc
Convert the floating point value into unsigned integer.
[ public, static ]
UInt32 utrunc(
    Float64 value   
);

Description

Truncating any fractional part.

The SFXHelper::utrunc function can be used for BREW SDK version 3.1 or later.

Reference

BREW API UTRUNC


SFXHelper::vsnprintf
Write a formatted output to the stream.
[ public, static ]
SInt32 vsnprintf(
    ACharPtr destination   // to store output
    UIntN size             // buffer size
    ACharConstPtr format   // format control string
    va_list argument       // optional argument list
);

Reference

BREW API VSNPRINTF


SFXHelper::vsprintf
This function corresponds to the vsprintf() function in the standard C library.
[ public, static ]
SInt32 vsprintf(
    ACharPtr destination   // to store output
    ACharConstPtr format   // format control string
    va_list argument       // optional argument list
);

Reference

BREW API VSPRINTF


SFXHelper::wgs84_to_degrees
Convert latitude or longitude in WGS84 format into Degree decimal format
[ public, static ]
Float64 wgs84_to_degrees(
    SInt32 value   // latitude or longitude in WGS84 format
);

Description

The SFXHelper::wgs84_to_degrees function can be used for BREW SDK version 2.1 or later.

Reference

BREW API WGS84_TO_DEGREES


SFXHelper::wsprintf
Similar to the SPRINTF() function, used for the WChar string.
[ public, static ]
Void wsprintf(
    WCharPtr destination   // to store output
    UIntN size             // size of the destination buffer (in bytes)
    WCharConstPtr format   // format control string
    ...                    // optional argument
);

Reference

BREW API WSPRINTF


SFXHelper::wstrcat
Similar to the STRCAT() function, used for the WChar string.
[ public, static ]
WCharPtr wstrcat(
    WCharPtr destination   // pointer to the NULL terminated destination string
    WCharConstPtr source   // pointer to the NULL terminated source string
);

Reference

BREW API WSTRCAT


SFXHelper::wstrchr
Similar to the STRCHR() function, used for the WChar string.
[ public, static ]
WCharPtr wstrchr(
    WCharConstPtr string   // null terminated WChar string to search
    WChar character        // character to be located
);

Reference

BREW API WSTRCHR


SFXHelper::wstrcmp
Similar to the STRCMP() function, used for the WChar string.
[ public, static ]
SInt32 wstrcmp(
    WCharConstPtr left    // pointer to first NULL terminated string
    WCharConstPtr right   // pointer to second NULL terminated string
);

Reference

BREW API WSTRCMP


SFXHelper::wstrcompress
Compress the input WChar string.
[ public, static ]
Void wstrcompress(
    WCharConstPtr source   // source character string ended by null
    SInt32 length          // length of the source string (in AECHARs)
    ACharPtr destination   // pointer to the destination buffer
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API WSTRCOMPRESS


SFXHelper::wstrcpy
Similar to the STRCPY() function, used for the WChar string.
[ public, static ]
WCharPtr wstrcpy(
    WCharPtr destination   // pointer to destination string
    WCharConstPtr source   // pointer to source character string
);

Reference

BREW API WSTRCPY


SFXHelper::wstrdup
Similar to the STRDUP() function, used for the WChar string.
[ public, static ]
WCharPtr wstrdup(
    WCharConstPtr string   // string to be copied
);

Reference

BREW API WSTRDUP


SFXHelper::wstricmp
Similar to the STRICMP() function, used for the WChar string.
[ public, static ]
SInt32 wstricmp(
    WCharConstPtr left    // pointer to the null terminated string to be compared
    WCharConstPtr right   // pointer to the null terminated string to be compared
);

Reference

BREW API WSTRICMP


SFXHelper::wstrlcat
Similar to the STRLCAT() function, used for the WChar string.
[ public, static ]
SInt32 wstrlcat(
    WCharPtr destination   // destination string. string to concatenate into
    WCharConstPtr source   // source string. string to copy from
    SInt32 size            // size of destination buffer (in AECHAR)
);

Reference

BREW API WSTRLCAT


SFXHelper::wstrlcpy
Similar to the STRLCPY() function, used for the WChar string.
[ public, static ]
SInt32 wstrlcpy(
    WCharPtr destination   // destination string. string to copy into.
    WCharConstPtr source   // source string. string to copy from
    SInt32 size            // size of destination buffer (in AECHAR)
);

Reference

BREW API WSTRLCPY


SFXHelper::wstrlen
Similar to the STRLEN() function, used for the WChar string.
[ public, static ]
SInt32 wstrlen(
    WCharConstPtr string   // null terminated string whose length is to be determined
);

Reference

BREW API WSTRLEN


SFXHelper::wstrlower
Similar to the STRLOWER() function, used for the WChar string.
[ public, static ]
Void wstrlower(
    WCharPtr string   // string to be converted into small letter
);

Reference

BREW API WSTRLOWER


SFXHelper::wstrncmp
Similar to the STRNCMP() function, used for the WChar string.
[ public, static ]
SInt32 wstrncmp(
    WCharConstPtr left    // pointer to the null terminated string to be compared
    WCharConstPtr right   // pointer to the null terminated string to be compared
    SInt32 length         // maximum number of AECHARS to compare
);

Reference

BREW API WSTRNCMP


SFXHelper::wstrncopyn
Copy specified length of the source string into destination.
[ public, static ]
SInt32 wstrncopyn(
    WCharPtr destination   // destination string
    SInt32 size            // size of the destination (in AECHAR)
    WCharConstPtr source   // source string
    SInt32 length          // the maximum string length to copy
);

Reference

BREW API WSTRNCOPYN


SFXHelper::wstrnicmp
Similar to the STRNICMP() function, used for the WChar string.
[ public, static ]
SInt32 wstrnicmp(
    WCharConstPtr left    // pointer to the null terminated string to be compared
    WCharConstPtr right   // pointer to the null terminated string to be compared
    SInt32 length         // maximum number (in AECHAR ) can be compared 
);

SFXHelper::wstrrchr
Similar to the STRRCHR() function, used for the WChar string.
[ public, static ]
WCharPtr wstrrchr(
    WCharConstPtr string   // null terminated WChar string to search
    WChar character        // character to be located
);

Reference

BREW API WSTRRCHR


SFXHelper::wstrsize
Return the size, in bytes, of a WChar string.
[ public, static ]
UIntN wstrsize(
    WCharConstPtr string   // valid pointer to a null-terminated wide string
);

Reference

BREW API WSTRSIZE


SFXHelper::wstrtofloat
Convert a WChar string into a floating point value.
[ public, static ]
Float64 wstrtofloat(
    WCharConstPtr string   // pointer to null terminated wide string to be converted to float
);

Reference

BREW API WSTRTOFLOAT


SFXHelper::wstrtostr
Convert a WChar string into an AChar string.
[ public, static ]
ACharPtr wstrtostr(
    WCharConstPtr source   // pointer to null terminated WChar string to be converted to AChar string
    ACharPtr destination   // pointer to destination buffer to store the AChar string
    UIntN size             // size of the destination buffer (in bytes)
);

Reference

BREW API WSTRTOSTR


SFXHelper::wstrtoutf8
Convert a WChar string to UTF8 string.
[ public, static ]
Bool wstrtoutf8(
    WCharConstPtr source   // input string
    SInt32 length          // length of input string (in AECHARs)
    ACharPtr destination   // destination string
    UIntN size             // size of destination (in bytes)
);

Reference

BREW API WSTRTOUTF8


SFXHelper::wstrupper
Similar to the STRUPPER() function, used for the WChar string.
[ public, static ]
Void wstrupper(
    WCharPtr string   // string to be converted into capital letter
);

Reference

BREW API WSTRUPPER


SFXHelper::wwritelong
Write a decimal value as zero-terminated string.
[ public, static ]
WCharPtr wwritelong(
    WCharPtr destination   // valid pointer to a null-terminated WChar string to which the converted long is written
    SInt32 value           // number of long type
);

Reference

BREW API WWRITELONG


SFXHelper::wwritelongex
Convert long type into WChar string.
[ public, static ]
WCharPtr wwritelongex(
    WCharPtr destination   // valid pointer to a null terminated WChar string to which the converted long is written
    SInt32 value           // number of long type
    SInt32 padding         // maximum amount of padding
    SInt32Ptr result       // on input, this pointer points to an integer that specifies the size the destination (in AECHARs)
                           // on output, this points to an integer that denotes the unused space (in terms of number of ARCHARs) left in the destination
       
);

Reference

BREW API WWRITELONGEX