Young S. Cho <[EMAIL PROTECTED]> wrote:
> What happened to the min/max functions?  [...]
> I thought that these were macros that were
> being defined previously...

Not everything which is defined in a header file found inside a Palm OS
SDK is a supported part of that SDK.  When something is documented, that
means it's supported.  Conversely, when something is not documented,
that's an indication that it's quite likely not to be supported.

"Not supported" means you shouldn't assume that something works or
is useful; or will stay the same or even exist at all in future SDKs.
Therefore, when you take advantage of functionality that is not
supported, you are taking a risk that your project will fail to work
or even fail to build with a later SDK.

No min and max macros have ever been documented or supported parts of
the Palm OS API.  As you have seen, in the 4.0 SDK they are not part
of the Palm OS API at all, as opposed to merely not being a supported
part of it.

On Tue, Nov 13, 2001 at 02:00:36AM +0900, IKEDA Shigeru wrote:
> Add the following line to your source files.
> 
> #include <PalmUtils.h>

You would do well to read the commentary in PalmUtils.h before blindly
#including it from your project.  It is not a supported part of the
Palm OS API.  It is in the SDK merely for the sake of the SDK examples,
and is subject to change.

You can insulate yourself from such change very easily.  Just Say No to
use of unsupported functionality!  It's very easy to define min and max
macros yourself in your project, or to use the superior functionality
available in various languages (e.g. C++'s <algorithm> and GNU C++'s <?
and >? operators).

    John

-- 
For information on using the Palm Developer Forums, or to unsubscribe, please see 
http://www.palmos.com/dev/tech/support/forums/

Reply via email to