home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine 1996 / ARCHIVE_96.iso / discs / gerald / 6_10 / CustomChck / ReadMe < prev   
Text File  |  1993-06-01  |  4KB  |  98 lines
  1. %OP%VS4.13 (28-Apr-92), Gerald L Fitton, R4000 5966 9904 9938 
  2. %OP%DP0
  3. %OP%IRY
  4. %OP%PL0
  5. %OP%HM0
  6. %OP%FM0
  7. %OP%BM0
  8. %OP%LM4
  9. %OP%PT1
  10. %OP%PDPipeLine
  11. %OP%WC1026,2262,188,1748,0,0,0,0
  12. %CO:A,72,72%
  13. %C%Custom Function monitoring facility for PipeDream 4
  14. %C%by Andrew Murray
  15. Keywords:
  16. Custom Monitor Murray 
  17.  
  18. The enclosed material may be useful to any of your members who are 
  19. involved in developing Custom Functions for PipeDream 4. It provides a 
  20. convenient facility for displaying custom function parameters (and 
  21. other values) within a custom function program under development. It 
  22. consists of a set of custom functions in the document [c_o], including 
  23. a function "example" designed to demonstrate the facilities provided, 
  24. which is invoked from the document [Example].
  25.  
  26. The functions intended to be invoked by the user are: "o", "s", "a" and 
  27. "oindex". Single character function names have been chosen for 
  28. convenience, to minimise typing, because the function calls are 
  29. intended to be used as a temporary debugging aid, to be removed as bugs 
  30. are corrected. All other function names are prefixed by "o_". It is 
  31. intended that all functions in [c_o], apart from "example" would be 
  32. copied into the user's function document and the name "o_switch" 
  33. defined and given the value 1. 
  34.  
  35. Two versions of the function "o" are provided. The first displays, in a 
  36. dialogue box, the function name and the parameters of the functions and 
  37. %H4%index%H4%es under test. If the "OK" button is selected, processing 
  38. continues to the next occurrence of "o" or "oindex". If the "Suppress" 
  39. button is chosen, the function "o" is ignored and "oindex" acts as 
  40. %H4%index%H4% until "o_switch" is reset to 1.
  41.  
  42. The alternative version of "o" is selected by applying the %H4%Number <> 
  43. Text%H4% command (\bnt) to the two "result" lines ([c_o]A22 and A27) and 
  44. loading the document [o]. This document provides space for the function 
  45. names and parameters to be displayed. The display area size may be 
  46. altered by changing the value of [o]all. "o" may still be inhibited by 
  47. resetting "o_switch" to zero, and "o_switch" is additionally used to 
  48. control the current line number within [o]. 
  49.  
  50. Slot [o]B1 resets "o_switch" to 1 each time [o] is loaded. When copying 
  51. the functions from [c_o], [o] should also be copied to the user's 
  52. directory and the function document name in [o]B1 corrected if 
  53. necessary. 
  54.  
  55. The function name and parameters of the functions and indexes under 
  56. test are displayed in the column specified by [o]all. When the column 
  57. is filled, it is overwritten. The lines are numbered to identify the 
  58. most recent. If the line is too long for the screen, it can be split in 
  59. the formula window in the normal way.
  60.  
  61. Both versions of "o" take two text parameters. The first parameter 
  62. identifies the function under test, the second specifies its 
  63. parameters. The parameters of the function under test are converted to 
  64. text strings by the functions "s" and "a", and if there are multiple 
  65. parameters, the strings should be concatenated with %H4%join%H4%.
  66.  
  67. The function "s" converts the parameter to a text string preceded by 
  68. "n:", "d:" or "t:" to identify number, date or text respectively. If 
  69. the parameter is an array, a line is displayed for each element of the 
  70. array, duplicated apart from the array parameter. The effect may be 
  71. seen in the example, in the treatment of @shortarray. This facility is 
  72. clearly not suitable for large arrays, and so the function "a" is 
  73. included to provide a more compact  presentation for an array. Only the 
  74. first element is shown, enclosed in4%index%H4% and, if valid, the value returned by the %H4%index%H4%, before 
  75. invoking the %H4%index%H4% function itself.
  76.  
  77. I hope some of your members find these facilities useful.
  78.  
  79. Andrew Murray
  80. 102 Aldermans Drive
  81. Peterborough
  82. PE3 6AZ
  83.  
  84. Telephone: 0 733 67185
  85.  
  86. 5th May 1993 
  87. FileDataéDetailsN D▐² xMoú\%OP%VS4.13 (28-Apr-92), Richard J Darby, R4001 0008 5218 9781 
  88. %OP%DFE
  89. %OP%PT1
  90. %OP%PDKXP1124L
  91. %OP%WC2,1238,44,980,0,1,0,0
  92. %CO:A,72,72%%C%Entering data column by column
  93.  
  94. I have been keeping weather records for ten years or so, and keeping 
  95. the data on computer to facilitate rapid recovery and compilation of 
  96. statistics.  For many years the data was kept on an Acorn Atom using 
  97. the Atomstore program.  When I obtained an Archimedes in 1988 I decided 
  98. to move the data onto a