Created Date: 12/29/2008
Last Updated: 2019-09-27 00:00:00
Description: Convert is a class that converts a base data type to another base data type.
Platforms: Windows; Unix; OpenVMS
Products: Synergy DBL
Minimum Version: 9.1.5b
Author: Tod Phillips
Additional Information: Its current implementation has only one static method (ToBase64String) with several overloads. It can be used in conjunction with the AsciiEncoding class's "GetBytes" method (available as a separate download on the CodeExchange) or accessed with an alpha parameter instead.
In order to use this class, it must first be prototyped with the DBLPROTO utility. Ensure that your SYNIMPDIR and SYNEXPDIR environment variables have been set, then run the protyper by typing:
dblproto Convert
from a command prompt in the directory where the Convert.dbl file has
been saved. (Alternately, import the file into a Workbench project, right-
click the project in the Projects tab and select "Generate Synergy
Protypes..."). The included file can then be compiled and added to any
library or ELB. To use the provided class methods, simply type
import SynPSG.System
at the top of your source code. (See Example, below).
CLASS: Convert (Public)
ENUMERATION(S): Public Enumeration Base64FormattingOptions InsertLineBreaks None
CONSTRUCTOR: None (Convert should include only static members, so it does not need instantiation to access its members).
PROPERTIES: None
METHOD(S): ToBase64String Overloaded. Converts the value of an array of 8-bit unsigned integers to its equivalent String representation encoded with base 64 digits.
Usage & Overloads
Convert.ToBase64String(a_ByteArray[#], Base64FormattingOptions)
a_ByteArray is a Dynamic System Array of 8-bit unsigned integers
to be converted to Base64
a_formatOption is a Base64FormattingOptions enumeration which causes
the method to either insert a line break every 76 characters (default),
or to not insert line breaks at all.
Convert.ToBase64String(a_ByteArray[#])
a_ByteArray is a Dynamic System Array of 8-bit unsigned integers
to be converted to Base64.
Convert.ToBase64String(a a_Alpha)
a_Alpha is an alphanumeric string that will be returned as a Base64 string
EXAMPLE(S):
The following program demonstrates the use of the ToBase64String method.
;; Program to demonstrate the Convert.ToBase64String method.
import SynPSG.System
main
record
b64String ,string
oldString ,a256
endrecord
proc
open(1,O,'TT:')
oldString = "This is a test."
writes(1,"Original String:")
writes(1,%atrim(oldString))
writes(1,"")
b64String = Convert.ToBase64String(%atrim(oldString))
writes(1,"Converted String:")
writes(1,b64String)
end