home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / adhesive_1 / goodies / basicC / Example / Info < prev    next >
Encoding:
Text File  |  1994-09-23  |  1.9 KB  |  56 lines
  1. The basic programs "Adhesive","BasicC","UsefulBits" provide the following
  2. procedures. See the example program 'Example'. You can use these in your
  3. own programs.
  4.  
  5. Set the current directory to be this one and then run 'Example' to
  6. try the example. (Double click on SetDir to set the current directory.)
  7.  
  8.  
  9. PROC_AdhesivePreInit
  10. Assembles Adhesive interface code and registers and exit handler to clean
  11. up when your program terminates.
  12.  
  13. PROC_AdhesiveInit(n$)
  14. Register with Adhesive, pass the name of your program in n$.
  15.  
  16. PROC_AdhesiveRequest(r)
  17. Request objects defined in the request block at r from Adhesive.
  18.  
  19. PROC_AdhesiveClose
  20. Call this if you wish to deregister with Adhesive before your program
  21. exits. Otherwise this is done automatically for you when the program ends.
  22.  
  23. PROC_StringFrom0(A%)
  24. Converts string at A% from &0D to &00 terminator.
  25.  
  26. PROC_StringTo0(A%)
  27. Converts string at A% from &00 to &0D terminator.
  28.  
  29. FN_CCall(x)
  30. Given a Shared C Library entry point number (as defined in the file
  31. tools/ShLib with your copy of Adhesive) return the address of this function.
  32.  
  33. PROC_BasicCInit
  34. Initialises the basicC object so you can now call C functions. Do not call
  35. this more than once. You need to decrease HIMEM by at least 16K first. The
  36. example program shows you how to do this.
  37.  
  38. FN_AssembleRequests_basicC
  39. Pass this to PROC_AdhesiveRequest() after calling PROC_AdhesiveInit and before
  40. calling PROC_BasicCInit. See the 'Example' program.
  41.  
  42. PROC_UsefulBitsInit
  43. Setup some variables giving the addresses of some common C functions. See
  44. the file 'UsefulBits' for details.
  45.  
  46. FN_Malloc(size%)
  47. Allocate size% bytes of memory. Returns a pointer to it or 0 if no space
  48. left. Your wimpslot will be increased if needed.
  49.  
  50. FN_Zmalloc(size%)
  51. Allocate size% bytes of memory. Returns a pointer to the space. Creates an
  52. ERROR if there is no memory left.
  53.  
  54. PROC_Free(space%)
  55. Free previously allocated block from malloc(). Does nothing if passed 0.
  56.