Home > Class Reference > ENSLIB namespace > %Library.String
Private  Storage   


datatype class %Library.String extends %DataType


The %String data type class represents a string.

The logical value of the %String data type is a string.


Parameters Properties Methods Queries Indices ForeignKeys Triggers
11 7


DisplayToLogical IsValid LogicalToDisplay LogicalToOdbc
LogicalToXSD Normalize XSDToLogical

%Activate.SafeArray %Activate.UserDefined %BI.ConditionName
%CSP.Util.Choice %CSP.Util.Passwd %DeepSee.Datatype.className
%DeepSee.Datatype.entityName %DeepSee.Datatype.expression %DeepSee.Datatype.function
%DeepSee.Datatype.list %DeepSee.Datatype.propertyName %DeepSee.Datatype.string
%DeepSee.PMML.Datatype.String %DeepSee.XMLA.String %Library.Char
%Library.ExactString %Library.NetworkAddress %Library.Text
%Monitor.String %OAuth2.JSONString %OAuth2.uri
%SYS.AuditString %SYS.Task.Password %Standards.AU.eHealth.PCEHR.ihiNumber
%Text.Text %XML.GUID %XML.Id
%XML.Oid %XML.String %ZEN.Datatype.datatype
%xsd.anyURI %xsd.duration %xsd.string
Ens.DataType.Class Ens.DataType.ConfigName Ens.DataType.Directory
Ens.DataType.Filename Ens.DataType.TCPAgentPort EnsLib.RecordMap.Model.DataType.RecordType
EnsLib.UDDI.DT.FindQualifier EnsLib.UDDI.uddi.authInfo EnsLib.UDDI.uddi.authorizedName
EnsLib.UDDI.uddi.completionStatus EnsLib.UDDI.uddi.direction EnsLib.UDDI.uddi.infoSelection
EnsLib.UDDI.uddi.keyName EnsLib.UDDI.uddi.keyType EnsLib.UDDI.uddi.keyValue
EnsLib.UDDI.uddi.sortCode EnsLib.UDDI.uddi.uddiKey EnsLib.UDDI.uddi.useType
EnsLib.UDDI.uddi.validationTypeAnyURI4096 EnsLib.UDDI.uddi.validationTypeString255 EnsLib.UDDI.uddi.validationTypeString4096
EnsLib.UDDI.uddi.validationTypeString50 EnsLib.UDDI.uddi.validationTypeString80 EnsLib.UDDI.uddi.validationTypeString8192
EnsLib.ebXML.schema.msg.messageStatus.type EnsLib.ebXML.schema.msg.nonemptystring EnsLib.ebXML.schema.msg.severity.type


• parameter COLLATION;
The default collation value used for this data type. Note that if you specify a truncation length and also a VALUELIST then your truncation length must be longer or equal to your longest VALUELIST value
• parameter CONTENT = "STRING";
XML element content "MIXED" for mixed="true" and "STRING" or "ESCAPE" for mixed="false". If CONTENT="STRING" (default) XML special characters are put in a CDATA section during XML export. If CONTENT="ESCAPE" XML special characters are escaped during XML export. If CONTENT="ESCAPE-C14N" XML special characters are escaped during XML export using the translate table, XMLC, specified for XML Canonicalizaton. The main difference is that CR is escaped as 
• parameter DISPLAYLIST;
Used for enumerated (multiple-choice) attributes. Used in conjunction with the VALUELIST parameter for enumerated (multiple-choice) attributes. DISPLAYLIST, if not null, represents the display values for the attribute corresponding with the logical values listed in VALUELIST.

The display values are returned by the LogicalToDisplay method.

• parameter ESCAPE = "XML";
Controls the translate table used to escape content when CONTENT="MIXED" is specified.
• parameter MAXLEN = 50;
The maximum number of characters the string can contain.
• parameter MINLEN;
The minimum number of characters the string can contain.
• parameter PATTERN;
A pattern which the string should match.

The value of PATTERN should be a valid Caché pattern match expression.

• parameter TRUNCATE = 0;
Determines whether to truncate the string to MAXLEN characters.
• parameter VALUELIST;
Used for enumerated (multiple-choice) attributes. VALUELIST is either a null string ("") or a delimiter separated list (where the delimiter is the first character) of logical values. If a non-null value is present, then the attribute is restricted to values in the list, and the validation code simply checks to see if the value is in the list.
Used to specify the name of the parameter which contains the enumeration list for XML values. The parameter which contains the list must be in the format used for VALUELIST and DISPLAYLIST. The default is VALUELIST.
• parameter XSDTYPE = "string";
Declares the XSD type used when projecting XML Schemas.


• classmethod DisplayToLogical(%val As %String) as %String
Converts the input value %val, which is a string, into the logical string format. Returns the logical value of the input string %val.
• classmethod IsValid(%val As %CacheString) as %Status
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, VALUELIST, and PATTERN.
• classmethod LogicalToDisplay(%val As %String) as %String
Converts the value of %val, which is in logical format, into a display string. Removes all the null characters from the string.

Returns the string value of %val.

• classmethod LogicalToOdbc(%val As %String) as %String
Converts the value of %val, which is in logical format, into a Odbc string. This only truncates a single field value to 32749 characters if MAXLEN is longer than 32749.

Returns the string value of %val.

• classmethod LogicalToXSD(%val As %String) as %String
If XMLLISTPARAMETER is specified, XSDToLogical is generated which exports using the list specified by XMLLISTPARAMETER.
• classmethod Normalize(%val As %CacheString) as %String
Truncates value %val to MAXLEN, characters.
• classmethod XSDToLogical(%val As %String) as %String
If XMLLISTPARAMETER is specified, XSDToLogical is generated which imports using the list specified by XMLLISTPARAMETER.