home *** CD-ROM | disk | FTP | other *** search
/ NetNews Offline 2 / NetNews Offline Volume 2.iso / news / comp / sys / amiga / programmer / 6656 < prev    next >
Encoding:
Internet Message Format  |  1996-08-05  |  4.0 KB
  1. Path: easy.in-chemnitz.de!mkmk!floh
  2. From: floh@mkmk.in-chemnitz.de (Andre Weissflog)
  3. Newsgroups: comp.sys.amiga.programmer
  4. Subject: Re: include:clib/stdio_protos.h - where is it?
  5. Message-ID: <wMfky*sI0@mkmk.in-chemnitz.de>
  6. Date: Sat, 30 Mar 1996 13:46:08 CET
  7. Reply-To: floh@mkmk.in-chemnitz.de
  8. References: <354.6656T1088T147@mistral.co.uk> <4iIiy*XH0@mkmk.in-chemnitz.de>
  9.  <1035.6658T1363T2026@mistral.co.uk>
  10. Distribution: world
  11. Organization: private uucp site
  12. X-Newsreader: Arn V 1.04
  13.  
  14. In article <1035.6658T1363T2026@mistral.co.uk>, Adam Atkinson writes:
  15.  
  16. > On 25-Mar-96 19:35:16, Andre Weissflog said:
  17. > 
  18. > >I guess they mean <clib/alib_stdio_protos.h>. I would recommend
  19. > >*not* to use those functions unless you know exactly what you're 
  20. > >doing, instead use the vanilla ANSI-stdio-functions that came
  21. > >with your compiler's c.lib, they are more powerful, and
  22. > >compatible with the rest of the ANSI file io stuff.
  23. > 
  24. > Most people seem to have given me exactly the opposite advice. i.e. don't
  25. > mix ansi and amiga-specific stuff unless there is a good reason to. I'm
  26. > still feeling pretty lost, but my first 2 programs have compiled and work,
  27. > which is something.
  28. > 
  29.  
  30. Uhmm, yes, they are right, and my statement was possibly a bit
  31. too short...
  32.  
  33. ANSI C specifies a few hundred support functions that cover stuff
  34. like file i/o, string manipulation, memory management etc etc 
  35. etc... This is the common programming environment you can expect
  36. from any ANSI compiler on any machine in the galaxy (and possibly
  37. beyond). This programming environment is basically like a
  38. operating system on its own, however this "os" is always built
  39. on top of the native operating system of the machine (with the
  40. exception of elevator controllers maybe).
  41.  
  42. AmigaOS offers hundreds of functions too, also covering stuff
  43. like memory management, file i/o etc...
  44.  
  45. That's the reason why one should not mix ANSI style and AmigaOS
  46. style programming. It's certainly possible to some degree, but 
  47. leads to unreadably code and what you get in the end are all the 
  48. disadvantages of both worlds. One of the few exceptions are 
  49. ANSI C's string manipulation functions, like strcpy(), because 
  50. they have no AmigaOS equivalent.
  51.  
  52. Thus: If you want to be sure your program compiles also on
  53. other systems, do it 100% ANSI C. It's completely fine to
  54. do console based programs that way on the Amiga, where you
  55. can go to the SGI next door and recompile and use it
  56. there without one change.
  57.  
  58. If you want to write a program that makes use of the phantastic
  59. AmigaOS stuff, then go with the AmigaOS's functions as much
  60. as possible (and buy the ROM Kernel Reference Manuals please).
  61.  
  62. Phew... now to alib_stio_protos.h:
  63.  
  64. If you look at that file, you see those prototype definitions:
  65.  
  66.     LONG printf( STRPTR fmt, ... );
  67.     LONG sprintf( STRPTR buffer, STRPTR fmt, ... );
  68.     LONG fclose( long stream );
  69.     LONG fgetc( long stream );
  70.     LONG fprintf( long stream, STRPTR fmt, ... );
  71.     LONG fputc( long c, long stream );
  72.     LONG fputs( UBYTE *s, long stream );
  73.     LONG getchar( void );
  74.     LONG putchar( long c );
  75.     LONG puts( BYTE *s );
  76.  
  77. The names are clearly ANSI C, but the used datatypes are
  78. Amiga style. Those functions are neither clean ANSI C, nor 
  79. AmigaOS. They encapsulate AmigaOS calls, but are "bastards" from 
  80. the outside.
  81.  
  82. Why C= ever created those functions probably only know the
  83. AmigaOS tribal elders. The only advantage one gets from using them
  84. is smaller programs (somewhere around 3..5 KByte smaller because
  85. shared library code is used and several startup initialisations
  86. are not needed). The main disadvantage is you can't mix them
  87. with all the other nice ANSI file i/o functions, because different
  88. file descriptors are used. And you must make sure to link amiga.lib
  89. before c.lib, or the linker will use the c.lib versions anyway.
  90.  
  91. Everything clear now? :-)
  92.  
  93. Bye,
  94. -Floh.
  95.  
  96. ====//=== Andre Weissflog <floh@mkmk.in-chemnitz.de> =======
  97. ...//..........."Spirits in the material world"............
  98. \\//......90% of everything is crap (Sturgeon's Law)......
  99. =\\===============================================Amiga!=
  100.  
  101.