The Regnus Parser For VB6
About
The Regnus Parser for VB6 is a VB6 module which will allow you to generate text from Regnus scripts from within applications written in VB6.
To discuss this parser, or to make feature requests or bug reports, please visit its forum.
Note: due to limitations in VB6's character display support, it is recommended that Regnus scripts parsed using this parser use the local Windows code page for character mapping rather than UTF-8, as scripts using extended unicode characters may not display correctly.
Information & Download
- Parser Version
- v1.3.2
- Regnus Specification
- v5.5
- Download
Using The Regnus Parser For VB6
To use the Regnus Parser For VB6 in your programs, you will need to first download and unzip the module file, and include it in your project.
Once your project contains the module, producing text from a Regnus script is very simple. The main function parser is 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("Something Completely Different.rsf", "RANDOM PICK")
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")
Version History
v1.3.2
- Removed redundant code to improved parser efficiency.
- Improved behaviour of automatic pluralisation function.
v1.3.1
- Fixed bug causing aliases not to function correctly.
v1.3.0
- Fixed bugs causing labels in "RATIO" and "COUNT" entries not to function correctly.
- Improved and corrected several bodies of code relating to labels.
- Implemented support for the Regnus 5.5 "START" qualifier.
- Implemented support for Regnus 5.5 fractional ratios.
- Implemented support for Regnus 5.5 dice notation.
- Improved and corrected code for detail and accuracy of error reporting during script parsing.
- Implemented support for Rgenus 5.5 inline entry selection.
- Improved code for accuracy and efficiency.
- Fixed bug causing "COUNT" qualifier not to work correctly.
v1.2.5
- Fixed bug causing numeric values not to be parsed correctly for nested references.
v1.2.4
- Fixed bug causing pluralisation not to work correctly when combined with capitalisation.
- Minor code tidying.
v1.2.3
- Fixed two bugs causing errors due to erroneous case-sensitivity when using REFER and COUNT qualifiers.
v1.2.2
- Added workaround for undocumented VB6 behaviour in order to fix serious bug affecting groups with names beginning with certain letters.
v1.2.1
- Parser now correctly returns an empty result when seeking an alias for an empty expression.
- Parser now gives priority to longer phrases when using MULTI qualifiers, in order to generate more intuitive output.
v1.2.0
- Updated parser for compliancy with Regnus specification 5.4.
- Nested hidden text brackets now function correctly.
- Multiple MULTI qualifiers no longer erroneously cause multiple plurals to be returned.
- Parser now uses arrays rather than string processing for additional elegance, efficiency and parsing speed.
v1.1.0
- Parser updated to support Regnus specification 5.3.
v1.0.0
- First release.