IRISLIB database
String Class Reference

The String data type class represents a string. More...

Inheritance diagram for String:
Collaboration diagram for String:

Static Public Member Functions

_.Library.String DisplayToLogical (_, _.Library.String val)
 Converts the input value val, which is a string, into the logical string format. More...
 
_.Library.Status IsValid (_, _.Library.RawString val)
 Tests if the logical value val, which is a string, is valid. More...
 
_.Library.String JSONToLogical (_, _.Library.String val)
 If JSONLISTPARAMETER is specified, XSDToLogical is generated which imports using the list specified by JSONLISTPARAMETER.
 
_.Library.String LogicalToDisplay (_, _.Library.String val)
 Converts the value of val, which is in logical format, into a display string. More...
 
_.Library.String LogicalToJSON (_, _.Library.String val)
 If JSONLISTPARAMETER is specified, XSDToLogical is generated which exports using the list specified by JSONLISTPARAMETER.
 
_.Library.String LogicalToXSD (_, _.Library.String val)
 If XMLLISTPARAMETER is specified, XSDToLogical is generated which exports using the list specified by XMLLISTPARAMETER.
 
_.Library.String Normalize (_, _.Library.RawString val)
 Truncates value val to MAXLEN, characters.
 
_.Library.String XSDToLogical (_, _.Library.String val)
 If XMLLISTPARAMETER is specified, XSDToLogical is generated which imports using the list specified by XMLLISTPARAMETER.
 

Static Public Attributes

 COLLATION = None
 The default collation value used for this data type. More...
 
 CONTENT = None
 XML element content "MIXED" for mixed="true" and "STRING" or "ESCAPE" for mixed="false". More...
 
 DISPLAYLIST = None
 Used for enumerated (multiple-choice) attributes. More...
 
 ESCAPE = None
 Controls the translate table used to escape content when CONTENT="MIXED" is specified.
 
 JSONLISTPARAMETER = None
 Used to specify the name of the parameter which contains the enumeration list for JSON values. More...
 
 JSONTYPE = None
 JSONTYPE is JSON type used for this datatype.
 
 MAXLEN = None
 The maximum number of characters the string can contain. More...
 
 MINLEN = None
 The minimum number of characters the string can contain.
 
 PATTERN = None
 A pattern which the string should match. More...
 
 TRUNCATE = None
 Determines whether to truncate the string to MAXLEN characters.
 
 VALUELIST = None
 Used for enumerated (multiple-choice) attributes. More...
 
 XMLLISTPARAMETER = None
 Used to specify the name of the parameter which contains the enumeration list for XML values. More...
 
 XSDTYPE = None
 Declares the XSD type used when projecting XML Schemas.
 
- Static Public Attributes inherited from DataType
 INDEXNULLMARKER = None
 Override this parameter value to specify what value should be used as a null marker when a property of the type is used in a subscript of an index map. More...
 

Detailed Description

The String data type class represents a string.

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

Member Function Documentation

◆ DisplayToLogical()

_.Library.String DisplayToLogical (   _,
_.Library.String  val 
)
static

Converts the input value val, which is a string, into the logical string format.

Returns the logical value of the input string val.

◆ IsValid()

_.Library.Status IsValid (   _,
_.Library.RawString  val 
)
static

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.

Reimplemented from DataType.

Reimplemented in Text, and NetworkAddress.

◆ LogicalToDisplay()

_.Library.String LogicalToDisplay (   _,
_.Library.String  val 
)
static

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.

Member Data Documentation

◆ COLLATION

COLLATION = None
static

The default collation value used for this data type.

Note that if you specify a truncation length and also a <parameter>VALUELIST</parameter> then your truncation length must be longer or equal to your longest VALUELIST value

◆ CONTENT

CONTENT = None
static

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 &#13;

◆ DISPLAYLIST

DISPLAYLIST = None
static

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.

◆ JSONLISTPARAMETER

JSONLISTPARAMETER = None
static

Used to specify the name of the parameter which contains the enumeration list for JSON values.

The parameter which contains the list must be in the format used for VALUELIST and DISPLAYLIST. The default is VALUELIST.

◆ MAXLEN

MAXLEN = None
static

The maximum number of characters the string can contain.

The string may be any length.

◆ PATTERN

PATTERN = None
static

A pattern which the string should match.

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

◆ VALUELIST

VALUELIST = None
static

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.

◆ XMLLISTPARAMETER

XMLLISTPARAMETER = None
static

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.