Appendix — C library compatibility for RIM Wireless Handheld applications 71
Developer’s Guide – RIM 950 Wireless Handheld™
debugging messages can be output to the debug output w indow when
running MS Developer Studio by calling RimDebugPrintf.
Directory control functions
The RIM Wireless Handheld file system is different fr om those used on
desktop systems. As a result, the directory control functions are not
supported by the RIM Wireless Handheld.
Error and exception handling functions
The RIM Wireless Handheld environment does not support exception
handling. Serious failures, such as page faults, are handled by the system
function RimCatastrophicFailure, which may be called by
application code when an unrecoverable error is detected.
File handling functions
The RIM Wireless Handheld file system is different fr om those used on
desktop systems. As a result, the file handling functions ar e not
supported by the RIM Wireless Handheld.
Floating-point functions
Since the RIM Wireless Handheld has no floating p oint co- proc essor a nd
does not support application handling of traps and exceptions, f loating
point functions may not be used on the RIM Wireless Handheld, unless
all of the floating points are implemented by emulation without calls to
the operating system. However, the following functions are incorrectly
classified as floating point functions, and may be used without difficulty:
div, labs, ldiv, _lrotl, _lrotr, _max, _min, rand, _rotl, and _rotr.
Input and output functions
Any stream, file, or console input/output functions are not compa tible
with the RIM Wireless Handheld environment. The RIM Wireless
Handheld environment provides different mechanisms for keyboar d
input, LCD output, and file system access. Because of the way they are
implemented in the compiler library, this category also includes
sprintf and sscanf. These may not be used in a RIM Wireless
Handheld application. Use RimSprintf or RimVSprintf instead of
sprintf.
The port I/O functions, such as inp and outp, will not cause an error
during compilation, linking, or loading. However, because RIM Wireless