% %% %% %%%%%% %% % %%%%%% %%%% %% %% %% %% %% %%% %% %% %% %% %% %% %% %%%%% %%%%%% %% %%% %% %% %% %% %% %% %% %%%%% %% %% %% %%% %% %% %% %% %% %% v1.0 %% %% %% %% %%% %% %% %% %%%%%%% %%%%% %% %% %% %% %% %%% %% %% %% %% %% %% %%%% %% %% %% %% %% %% %% %% %% %% %% %% %%%%%% %%%%% %%% %%%% %% %% %%%% %%%% A String Buffer and Huge String Array Object Server Library Written specifically for Visual Basic for Windows Copyright © 1995, Greg Truesdell --------------------------------------------------------------------------- Introduction For a complete introduction to VBstrAPI, please take a look at the .WRI (Windows Write format) document inclosed and the introduction page in the Windows Help file VBstrAPI.HLP. VBstrAPI contains very fast, optimized objects for special string handling situations. This is not 'another' string library with a plethora of string functions, by a string object server library specifically for Visual Basic programmers and database application developers. The library MAY work with MS Access applications. There is no implied or specified guarrentee on that one way or the other! Demo Application The inclosed demo application is designed to show you how you might use the functions and objects available in VBstrAPI.DLL. You can either run the pre-compiled program or load the DEMOAPP.MAK file into Visual Basic and run it from there. A few things you should know before running the demo: 1. THREED.VBX is required. If you do not have it already, copy it to your WINDOWS\SYSTEM directory. 2. The VBstrAPI.DLL file may be left in the current directory. That is the directory you un-zipped the archive files into. The demo application sets the directory to the one it is running in. 3. The program uses VBstrAPI.DLL Objects and functions as part of its normal execution. It expects to see certain subroutines named as they are. This is so the program can locate the piece of code it wants to show to you. It is probably best to leave the subroutine names alone. 4. Because of the above (3.), the program requires that the .FRM files are saved as text. When you are playing with the program and modifying it, remember that you must save the project as text before running. 5. Look at ALL of the code. I have intentionally used CatStr objects liberally, even where it is not required. --------------------------------------------------------------------------- FOR UNREGISTERED USERS ONLY --------------------------------------------------------------------------- EVALUATION PERIOD AND RIGHTS You are granted a limited 30 day license to evaluate the usefulness of VBstrAPI.DLL in your environment. After that period, if you decide not to use the Library, then you must remove all files and archives containing the distribution files. This limited license is offered only once to a single individual or corporation. Please respect the intellectual property and development efforts of the author. You may re-distribute the Shareware Distribution Archive so long as you do not add, remove or alter any of it's contents nor charge a fee of any kind eccept that which is necessary to transmit, store or mail it. --------------------------------------------------------------------------- FOR REGISTERED USERS ONLY --------------------------------------------------------------------------- DISTRIBUTION OF VBSTRAPI.DLL WITH YOUR APPLICATIONS The REGISTERED VBstrAPI Archive now contains a Run-Time Only version of the library. The file is named VBSTRAPI.RTL and must be renamed to VBSTRAPI.DLL when included with your application disk or archive. You are lisensed to distribute ONLY the Run-Time version of the library. You may NOT distribute the developer's copy of VBSTRAPI.DLL! BUG REPORTS AND CHANGE REQUESTS As a registered user of VBstrAPI, you are allowed and encouraged to forward Bug Reports and Change Requests. Send your comments to CompuServe 74131,2175 or Internet Address 74131,2175@compuserve.com. BUG REPORTS When describing a possible bug, please include as much information as you can. If possible, send a code snippit that demonstrates the problem so I can reproduce it. Also, include the brand and type of computer you are using, RAM, CPU and etc. Please also quote the version and revision numbers for the library you have. As bugs are located, maintenance releases will become available to all registered users of VBstrAPI.DLL v1.xx in the MSBASIC forum on CompuServe. Each registered user is given the password for all update archives released for the major version you have registered. CHANGE REQUESTS Change Requests are accepted as commentary concerning the operation of VBstrAPI's objects and methods. These comments will be evaluated and implemented as deemed necessary by the author. However, all care will be taken to give credit to registered users whos ideas are implemented. In addition, if you have a specific need that would warrent a special modification of VBstrAPI, I will be happy to discuss making the change or addition at a nominal cost. Source code is not yet being made available, but special cases will be entertained. Please contact me through CompuServe. Improvements and additions to VBstrAPI have already begun, and will be available to registered users as soon as they are complete. THE STICKY LEGAL STUFF If you have purchased the Registered Version of VBstrAPI, then please remember that, although you may distribute the Run-Time Only version with your applications without royalties, you MUST NOT distribute VBSTRAPI.HLP or VBSTRAPI.BAS. These two files represent a covenant between the purchaser and the author and are CONFIDENTIAL. Only licensed users of the development package may legally possess these files. All registered versions of VBstrAPI are stamped with your registration identification. Decompiling or altering the library is strictly prohibited. You may produce any product you care to using this DLL, so long as you comply with the requirements stated above and in the .HLP file.