The Regnus Parser For QB4.5
About
The Regnus Parser for QB4.5 is a set of functions which will allow you to generate text from Regnus scripts from within applications written in QB4.5.
To discuss this parser, or to make feature requests or bug reports, please visit its forum.
Note: the Regnus Parser for QB4.5 does not currently support UTF-8 character sets.
Information & Download
- Parser Version
- v1.0.0
- Regnus Specification
- v5.2
- Download
Using The Regnus Parser For QB4.5
To use the Regnus Parser For QB4.5 in your programs, you will need to first download and unzip the source file which contains the functions.
You can include the functions in your project by copying and pasting from the source file, or using the File | Merge command.
Once your project contains all of the Regnus functions, producing text from a Regnus script is very simple. The main function parser is the function RegnusGenerate, which returns a string containing the generated text. For example, to generate text from a Regnus script and store it in YourString$:
YourString$ = RegnusGenerate(YourScript, YourLabel, Information)
YourScript should be the full relative path and file name of the script from which you would like to generate text, and YourLabel should be the label from which you would like to generate text. For example, to generate text from the "RANDOM PICK" label of the script Something Completely Different, in the working directory of the program:
YourString$ = RegnusGenerate("Someth~1.rsf", "RANDOM PICK", "")
Note: as in the example, remember that DOS filenames should generally be abbreviated using the above format if they exceed eight characters in length!
The optional Information argument causes the parser to instead output meta-information about the script, such as the script's Title or Blurb. For example, to get the script's Title:
YourString$ = RegnusGenerate("", "", "title")
And to return the script's blurb, of course:
YourString$ = RegnusGenerate("", "", "blurb")
Attribution
The Regnus Parser For QB4.5 is of course provided for use free of charge. However, if you do use Regnus in your programs, it would be nice if you could at least please include attribution somewhere in your credits or readme!
And of course, we'd love to hear about where and how you're using Regnus! If you'd like to tell us, or you have any other thoughts, questions, comments or suggestions about this parser or the language in general, please feel very welcome to post your messages in the Regnus forums!
Version History
v1.0.0
- First release.