home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / progc / v_array.arj / README.TXT < prev    next >
Encoding:
Text File  |  1991-09-06  |  4.0 KB  |  88 lines
  1. V_ARRAY.ZIP Contains the following files:
  2.  
  3. VIR.H         2351 -    Header file for virtual array functions
  4. VIR.OBJ         4911 -    Object file containing virtual array functions
  5. PRIMES.C     2325 -    Prime number generator source code
  6. PRIMES.EXE    65392 -    Prime number generator program
  7. README.TXT     4079 -    This text file
  8.  
  9.     The program PRIMES is a demonstration using a virtual array. To run 
  10. the program, simply type PRIMES at the DOS prompt. You will find that the prime 
  11. number generator quickly generates a large volume of primes. To stop the pro-
  12. gram, simply press a key (I suggest <space>). Whatever key you hit will be 
  13. passed on as if it was typed at the DOS prompt.
  14.  
  15.     PRIMES produces a file containing each prime number it generates. The
  16. prime numbers are stored as an array of long integers. PRIMES is capable of
  17. producing a list of all prime numbers less than 2,000,000,000 if you have the
  18. file space for it. Since such a large volume of prime numbers would take some
  19. time to compile, PRIMES has been designed to pick up where it left off when it
  20. is restarted. The file containing the prime numbers is named PRIMES.DAT.
  21.  
  22.     The virtual array functions in VIR.* are designed to allow access to 
  23. an arbitrarily large array. Any type of data or structure can be accessed with
  24. these functions. Array access is straight forward, allowing your code to be
  25. simple and uncluttered. All disk caching / swapping is done automatically by
  26. VIR.
  27.  
  28.     VIR doubles as a buffered file access method. Since the arrays that
  29. VIR produces become disk files, any disk file can be accessed as an array of
  30. elements. (For instance, characters, data records,..) VIR has provisions for 
  31. file sharing such as locking and unlocking groups of elements or denying access
  32. to files. In fact, VIR was developed as the primary file access method for a 
  33. multi-user relational data base.
  34.  
  35.     When initializing a virtual array, you are required to specify the 
  36. buffering characteristics. By altering these, you can achieve significant 
  37. improvements in overall program performance as well as insuring automatic
  38. transaction reversal (Requires TTS) in the event of a program crash.
  39.  
  40.     Since VIR takes care of all these nasty details, your application can
  41. get on with nifty algorythms such as shown in this demo. In fact, with an extra
  42. macro or two, you can access a virtual array almost the same as if it were a
  43. simple array. 
  44.  
  45. BUT ENOUGH EXPLAINING....
  46.  
  47.     The purpose of this demo is to bring in a couple dollars and give out a
  48. nifty little bit of code. Feel free to use these functions in any of your pro-
  49. grams. (if you can figure it all out.) It was compiled using the SMALL memory 
  50. model under TURBO C V2.0. I wish to ecnourage you to evaluate them. GOOD LUCK!
  51.  
  52.     If you come up with anything really nifty using this limited version,
  53. it would be nice to see my name mentioned in your source credits. I would also
  54. like to see a copy of the program and any comments you might have on how to 
  55. improve the functions. 
  56.  
  57.     Feel free also to pass this demo on to anyone you think might have a 
  58. use for it.... especially other BBS's! However, all of these files must remain
  59. intact and complete!
  60.  
  61. If you really want to be able to use these functions, simply send $10.00 to me:
  62.  
  63. Peter G. McNeil
  64. c/o Persnickety Inc.
  65. 22446 Davis Drive #187
  66. Sterling, Va. 22170
  67.  
  68. PHONES:-----------
  69. DAY (703) 450-6727 
  70. EVE (301) 725-3239 
  71. FAX (703) 450-5574
  72.  
  73. FOR THIS YOU GET!!!
  74.  
  75.     -    Complete source code for the VIR fucntions.
  76.     -    An explanation of each function and it's use.
  77.     -    A discussion of the caching/swaping algorythm.
  78.     -    A discussion of mult-user file access methods using VIR.
  79.  
  80. PLEASE SPECIFY 3.5" or 5.25" disk.
  81.  
  82. If you are a teacher and you want to use this in your class, I would be so
  83. tickled that I would send it to you for free! Just send me a letter on official
  84. letter head and it will be on it's way.
  85.  
  86.     This code represents a lot of thought, develpment, testing, and
  87. frustration. I hope it comes to some good use for you. It has proven very 
  88. useful to me. Thanks!!