CodeWarrior® MSL C Reference Because of last-minute changes to CodeWarrior, some of the information in this manual may be inaccurate. Please read the Release Notes on the CodeWarrior CD for the latest up-to-date information. Revised: 991202 rdl Metrowerks CodeWarrior copyright ©1993–1999 by Metrowerks Inc. and its licensors. All rights reserved. Documentation stored on the compact disk(s) may be printed by licensee for personal use. Except for the foregoing, no part of this documentation may be reproduced or transmitted in any form by any means, electronic or mechanical, including photocopying, recording, or any information storage and retrieval system, without permission in writing from Metrowerks Inc. Metrowerks, the Metrowerks logo, CodeWarrior, and Software at Work are registered trademarks of Metrowerks Inc. PowerPlant and PowerPlant Constructor are trademarks of Metrowerks Inc. All other trademarks and registered trademarks are the property of their respective owners. ALL SOFTWARE AND DOCUMENTATION ON THE COMPACT DISK(S) ARE SUBJECT TO THE LICENSE AGREEMENT IN THE CD BOOKLET. How to Contact Metrowerks: U.S.A. and international Metrowerks Corporation P.O. Box 334 Austin, TX 78758 U.S.A. Canada Metrowerks Inc. 1500 du College, Suite 300 Ville St-Laurent, QC Canada H4L 5G6 Ordering Voice: (800) 377–5416 Fax: (512) 873–4901 World Wide Web http://www.metrowerks.com Registration information [email protected] Technical support [email protected] Sales, marketing, & licensing [email protected] CompuServe goto Metrowerks Table of Contents 1 Introduction 19 CodeWarrior Year 2000 Compliance . 19 For additional information, visit: http:// www.metrowerks.com/about/y2k.html. 19 Organization of Files . 19 ANSI C Standard . 22 The ANSI C Library and Apple Macintosh . 22 Console I/O and the Macintosh . 22 Console I/O and Windows . 23 Compatibility . 23 2 alloca.h 25 Overview of alloca.h . 25 alloca . 25 3 assert.h 27 Overview of assert.h . 27 assert . 27 4 console.h 29 Overview of console.h. 29 ccommand . 30 clrscr . 33 getch . 33 InstallConsole . 34 kbhit . 34 ReadCharsFromConsole . 35 RemoveConsole . 35 __ttyname . 36 WriteCharsToConsole. 36 5 crtl.h 39 Overview of crtl.h . 39 Argc . 39 Argv . 40 _DllTerminate . 40 MSL C Reference MCR–3 environ . 40 _HandleTable . 40 _CRTStartup. 41 _RunInit . 41 _SetupArgs . 42 6 ctype.h 43 Overview of ctype.h . 43 Character testing and case conversion. 43 Character Sets Supported . 44 isalnum . 44 isalpha . 46 iscntrl. 47 isdigit. 47 isgraph . 48 islower . 48 isprint . 49 ispunct . 50 isspace . 50 isupper . 51 isxdigit . 51 tolower . 52 toupper . 53 7 div_t.h 55 Overview of div_t.h. 55 div_t . 55 ldiv_t . 55 8 errno.h 57 Overview of errno.h. 57 errno . 57 9 fcntl.h 61 Overview of fcntl.h . 61 fcntl.h and UNIX Compatibility . 61 creat . 61 fcntl . 63 MCR–4 MSL C Reference open . 64 umask . 68 10 float.h 69 Overview of float.h . 69 Floating point number characteristics . 69 11 FSp_fopen.h 71 Overview of FSp_fopen.h . 71 FSp_fopen. 71 12 io.h 73 Overview of io.h . 73 _chdir . 73 _chdrive . 74 _fileno . 74 _get_osfhandle. 75 _getcwd. 75 GetHandle . 76 _heapmin . 76 _isatty . 77 _makepath . 77 _open_osfhandle . 78 _searchenv . 78 13 limits.h 81 Overview of limits.h . 81 Integral type limits . 81 14 locale.h 83 Overview of locale.h . 83 Locale specification . 83 localeconv. 84 setlocale. 84 15 malloc.h 87 Overview of malloc.h . 87 alloca . 87 MSL C Reference MCR–5 16 math.h 89 Overview of math.h. 89 Floating point mathematics . 92 NaN Not a Number . 92 Floating point error testing. 93 Inlined Intrinsics Option . 93 Floating Point Classification Macros. 93 Enumerated Constants . 93 fpclassify . 94 isfinite . 95 isnan . 95 isnormal . 96 signbit . 96 Floating Point Math Facilities. 97 acos . 97 acosf . 98 acosl . 98 asin. 98 asinf . 99 asinl . 99 atan . 99 atanf . 100 atanl . 100 atan2 . 100 atan2f. 101 atan2l. 101 ceil . 101 ceilf . 102 ceill. 103 cos . 103 cosf. 104 cosl. 104 cosh . 104 coshf . 105 coshl . 105 exp . 105 expf . 106 MCR–6 MSL C Reference expl . 106 fabs . 106 fabsf . 107 fabsl . 108 floor . 108 floorf . 109 floorl . 109 fmod . 109 fmodf. 110 fmodl . 110 frexp . 110 frexpf . 111 frexpl . 112 isgreater . 112 isgreaterless . 112 isless . 113 islessequal. ..