Home > Class Reference > %SYS namespace > %Library.Binary

%Library.Binary

datatype class %Library.Binary extends %Library.DataType

ODBC Type: VARBINARY

The %Binary data type class is used to represent binary data. The logical value for %Binary is a string containing a binary value.

When a %Binary data type value is projected to a client application, such as when it is used in a Java, Visual Basic (ActiveX), ODBC, or JDBC application, the Object Server performs no translations or conversions on it. That is the actual binary data is sent to and from the client without any Unicode (or other) translations.

Method Inventory

Parameters

parameter CANONICALXML = 0;
If CANONICALXML is true, then the base64 output contains no white space.
parameter JSONTYPE = string;
parameter MAXLEN = 50;
The maximum number of characters the string can contain.
parameter MINLEN;
The minimum number of characters the string can contain.
parameter MTOM = 0;
If MTOM is true, then the property that references this binary data is available for optimization when using SOAP MTOM (Message Transmission Optimization Mechanism). The default for binary string data is false.
parameter XSDTYPE = base64Binary;
Declares the XSD type used when projecting XML Schemas.

Methods

classmethod IsValid(%val As %RawString) as %Status [ Language = objectscript ]
Tests if the logical value %val, which is a string, is valid. The validation is based on the class parameter settings used for the class attribute this data type is associated with. In this case, MINLEN, MAXLEN, and PATTERN.
classmethod JSONToLogical(%val As %String) as %Binary [ Language = objectscript ]
Converts the base64 encoded input value to a logical value.
classmethod LogicalToJSON(%val As %Binary) as %String [ Language = objectscript ]
Converts the logical %Binary value to the base64 encoded value.
classmethod LogicalToXSD(%val As %Binary) as %String [ Language = objectscript ]
Converts the %Binary value to the SOAP base64 encoded value.
classmethod XSDToLogical(%val As %String) as %Binary [ Language = objectscript ]
Converts the SOAP encoded base64 input value to a logical value.

Subclasses