AppendPemData (Stringlist subroutine)

Append PEM encoded string to a Stringlist (Stringlist class)

[Introduced in Model 204 7.5]

The PEM (Privacy Enhanced Mail) protocol uses base64 encoding for binary data that needs to be transferred and stored as text. AppendPemData lets you store PEM data as a series of base64 encoded Stringlist items within beginning and ending text marker items.

Syntax

sl:AppendPemData( [Data=] string, [label=] string)

Syntax terms

sl	A Stringlist object that contains labeled, base64 encoded data.
Data	The Longstring or String you are appending to the data stored in sl.
label	The string that identifies the base64 encoded data you are appending. The data is stored as a series of sl items contained within items that are the text markers -----BEGIN label----- and -----END label-----. This is a required, case-sensitive, value.

Usage notes

• The appended data is retrievable with the PemToString method.

Examples

b %ls is longstring %sl is object stringlist %ls = 'My PEM-structured content' %sl:Appendpemdata(%ls, 'SSL SESSION PARAMETERS') printtext {~} = {%sl:print} end

The result is:

%sl:print = -----BEGIN SSL SESSION PARAMETERS----- 1KhA18XUYKKjmaSDo6SZhYRAg5aVo4WVow== -----END SSL SESSION PARAMETERS-----

If you apply the Base64toString method to the string within the begin and end markers in the preceding result, that is:

printtext {~} = {'1KhA18XUYKKjmaSDo6SZhYRAg5aVo4WVow==':base64tostring}

The result is:

'1KhA18XUYKKjmaSDo6SZhYRAg5aVo4WVow==':base64tostring = My PEM-structured content

See also

Stringlist methods:

• AppendCertificateInfo
• AppendCertificateRequest
• AppendCertificateRequestInfo
• AppendClientCertificateRequest
• AppendEncryptedSecurityData
• AppendGeneratedPrivateKey
• AppendPemData
• AppendPrivateKeyInfo
• AppendSignedCertificate
• AppendSignedClientCertificate
• CheckCertificate
• CheckCertificateRequest
• PemToString

String methods:

• CertificateRequest
• SignedCertificate
• DerToXmlDoc
• RSAPrivateKeyToXmlDoc
• X509CertificateToXmlDoc
• X509CrlToXmlDoc
• Multiple cryptographic cipher methods

System methods:

• ClientCertificate,
• GeneratedPrivateKey

Socket methods:

• Certificate

Background information:

• "Abstract Syntax Notation One"
• "A Layman's Guide to a Subset of ASN.1, BER, and DER"

Stringlist class	List of Stringlist methods	Stringlist methods syntax
Notation conventions for methods