home *** CD-ROM | disk | FTP | other *** search
/ Really Useful CD 1 / ReallyUsefulCD1.iso / extras / progutils / baslib / baslibdoc / genlib < prev    next >
Encoding:
Text File  |  1989-03-15  |  2.4 KB  |  90 lines
  1. Routine   : PROCdelay(seconds)
  2. Library   : GenLib
  3. Purpose   : Pauses for the given number of 
  4.             seconds
  5. Source    : User
  6. Author    : Paul Hobbs
  7. Parameters: 
  8.    seconds          = the number of seconds to   
  9.                       wait for
  10. Dependant Routines: 
  11.    None
  12. Global Variables:
  13.    None 
  14. Notes:
  15.    A real number may be passed to the routine to 
  16.    pause for a decimal number of seconds, i.e. 
  17.    1.5. 
  18. Routine   : PROCwait_for_key(code)
  19. Library   : GenLib
  20. Purpose   : Waits for the specified key to 
  21.             be pressed and then continues 
  22.             the program.
  23. Source    : User
  24. Author    : Paul Hobbs
  25. Parameters:
  26.    code     = the ASCII code of the key to 
  27.               wait for.
  28. Dependant Routines:
  29.    None
  30. Global Variables: 
  31.    None
  32. Notes: 
  33.    None 
  34. Routine   : PROCdata_label_restore(label$) 
  35. Library   : GenLib
  36. Purpose   : Searches through the main 
  37.             program and any loaded libraries 
  38.             for the given data string. This 
  39.             may be used to restore the DATA 
  40.             pointer to a specific group of 
  41.             DATA items. 
  42. Source    : Risc User
  43. Author    : Lee Calcraft
  44. Parameters:
  45.    label$   = string to search for among the 
  46.               DATA statements. 
  47. Dependant Routines:
  48.    None
  49. Global Variables:
  50.    None 
  51. Notes: 
  52.    The routine is used as follows: to read 
  53.    data items associated with the label 
  54.    dp_Manuf the program would look like this 
  55.  
  56.      10 PROCdata_label_restore("dp_Manuf")
  57.      20 REM DATA pointer now points to the 
  58.         following item
  59.      30 REM rest of program
  60.      40 END
  61.      50 :
  62.      60 DATA dp_Manuf
  63.      70 DATA Ford,11.4,Saab,27.3,BL,12.6
  64.  
  65.    This has the advantage of not requiring 
  66.    the use of line numbers and therefore the 
  67.    DATA statements may be included in a 
  68.    library file.
  69. Routine   : PROCmem_move(source%,dest%,nr%) 
  70. Library   : GenLib
  71. Purpose   : Copies one block of memory to 
  72.             another block.
  73. Source    : User
  74. Author    : Paul Hobbs
  75. Parameters:
  76.    source%  = the address to move data from
  77.    dest%    = the destination address
  78.    nr%      = the number of bytes to move          
  79. Dependant Routines:
  80.    None
  81. Global Variables:
  82.    None 
  83. Notes: 
  84.    The destination memory block must lie outside 
  85.    the source block as otherwise the source may be 
  86.    overwritten by the copied bytes. As it is 
  87.    written in BASIC the routine will be relatively 
  88.    slow for moving large amounts of memory.
  89.  
  90.