%SYS.NLS.Table
class %SYS.NLS.Table extends %Library.RegisteredObject
NLS tables can be divided into I/O (also called translation) and Internal tables, each type having a set of categories:I/O tables
- Process
- InterSystems IRIS Terminal
- Other terminal
- File
- Magtape
- TCP/IP
- DSM-DDP
- DTM-DCP
- System call
- Printer
- Pattern match
- Identifier
- Uppercase
- Lowercase
- Titlecase
- Accent
- Collation
- $X/$Y action
A configuration allows a different system default to be selected among the available tables. Configuration defaults are optional and independent of the locale. They persist across system reboots and updates.
At startup, the system defaults are set either from the configured defaults or from the locale defaults. Configuration defaults have precedence if defined; otherwise the locale defaults are used.
When a process starts it inherits all the system defaults. The process setting for I/O tables can still be overriden when opening a device by specifying "K\TableName\" in the OPEN parameters.
This class has properties that represent each of the above categories.
To get the Configured defaults, instantiate an object with
Set obj=##class(%SYS.NLS.Table).%New("Config")
To get the loaded System defaults, instantiate an object with
Set obj=##class(%SYS.NLS.Table).%New("System")
To get the loaded Process settings, instantiate an object with
Set obj=##class(%SYS.NLS.Table).%New("Process")
Changing a property for a Process object immediately changes the corresponding setting in the process, but it is not possible to change the properties of a system object. Changes to a Config object will only affect the next system reboot.
For generic locale properties see %SYS.NLS.Locale.
For current device NLS properties see %SYS.NLS.Device.
For date, time and number format properties see %SYS.NLS.Format.
Property Inventory
- Accent
- CSP
- Collation
- DSMDDP
- DTMDCP
- File
- IRISTerminal
- Identifier
- Lowercase
- Magtape
- OtherTerminal
- PatternMatch
- Printer
- Process
- State
- SystemCall
- TCPIP
- Titlecase
- Uppercase
- XYAction
Method Inventory
Properties
property Accent as %String;
Property methods: AccentDisplayToLogical(), AccentIsValid(), AccentLogicalToDisplay(), AccentLogicalToOdbc(), AccentNormalize()
property CSP as %String;
Property methods: CSPDisplayToLogical(), CSPIsValid(), CSPLogicalToDisplay(), CSPLogicalToOdbc(), CSPNormalize()
property Collation as %String;
Property methods: CollationDisplayToLogical(), CollationIsValid(), CollationLogicalToDisplay(), CollationLogicalToOdbc(), CollationNormalize()
property DSMDDP as %String;
Property methods: DSMDDPDisplayToLogical(), DSMDDPIsValid(), DSMDDPLogicalToDisplay(), DSMDDPLogicalToOdbc(), DSMDDPNormalize()
property DTMDCP as %String;
Property methods: DTMDCPDisplayToLogical(), DTMDCPIsValid(), DTMDCPLogicalToDisplay(), DTMDCPLogicalToOdbc(), DTMDCPNormalize()
property File as %String;
Property methods: FileDisplayToLogical(), FileIsValid(), FileLogicalToDisplay(), FileLogicalToOdbc(), FileNormalize()
property IRISTerminal as %String;
Property methods: IRISTerminalDisplayToLogical(), IRISTerminalIsValid(), IRISTerminalLogicalToDisplay(), IRISTerminalLogicalToOdbc(), IRISTerminalNormalize()
property Identifier as %String;
Property methods: IdentifierDisplayToLogical(), IdentifierIsValid(), IdentifierLogicalToDisplay(), IdentifierLogicalToOdbc(), IdentifierNormalize()
property Lowercase as %String;
Property methods: LowercaseDisplayToLogical(), LowercaseIsValid(), LowercaseLogicalToDisplay(), LowercaseLogicalToOdbc(), LowercaseNormalize()
property Magtape as %String;
Property methods: MagtapeDisplayToLogical(), MagtapeIsValid(), MagtapeLogicalToDisplay(), MagtapeLogicalToOdbc(), MagtapeNormalize()
property OtherTerminal as %String;
Property methods: OtherTerminalDisplayToLogical(), OtherTerminalIsValid(), OtherTerminalLogicalToDisplay(), OtherTerminalLogicalToOdbc(), OtherTerminalNormalize()
property PatternMatch as %String;
Property methods: PatternMatchDisplayToLogical(), PatternMatchIsValid(), PatternMatchLogicalToDisplay(), PatternMatchLogicalToOdbc(), PatternMatchNormalize()
property Printer as %String;
Property methods: PrinterDisplayToLogical(), PrinterIsValid(), PrinterLogicalToDisplay(), PrinterLogicalToOdbc(), PrinterNormalize()
property Process as %String;
Property methods: ProcessDisplayToLogical(), ProcessIsValid(), ProcessLogicalToDisplay(), ProcessLogicalToOdbc(), ProcessNormalize()
property State as %Boolean;
True if translation is ON
Property methods: StateDisplayToLogical(), StateIsValid(), StateLogicalToDisplay(), StateNormalize()
property SystemCall as %String;
Property methods: SystemCallDisplayToLogical(), SystemCallIsValid(), SystemCallLogicalToDisplay(), SystemCallLogicalToOdbc(), SystemCallNormalize()
property TCPIP as %String;
Property methods: TCPIPDisplayToLogical(), TCPIPIsValid(), TCPIPLogicalToDisplay(), TCPIPLogicalToOdbc(), TCPIPNormalize()
property Titlecase as %String;
Property methods: TitlecaseDisplayToLogical(), TitlecaseIsValid(), TitlecaseLogicalToDisplay(), TitlecaseLogicalToOdbc(), TitlecaseNormalize()
property Uppercase as %String;
Property methods: UppercaseDisplayToLogical(), UppercaseIsValid(), UppercaseLogicalToDisplay(), UppercaseLogicalToOdbc(), UppercaseNormalize()
property XYAction as %String;
Property methods: XYActionDisplayToLogical(), XYActionIsValid(), XYActionLogicalToDisplay(), XYActionLogicalToOdbc(), XYActionNormalize()
Methods
Converts an external character set name to its internal name
Parameter:
Parameter:
- ext - External charset name (eg: "ISO-8859-2"). If it is already an internal name (eg: "UTF8"), it is returned unchanged (except that "Latin1" is returned as "RAW").
- Internal name equivalent to ext (eg: "Latin2")
- "" if there is no internal equivalent to 'ext'
Gets the name of an I/O table
Parameter: index - table index
Parameter: index - table index
- Process
- InterSystems IRIS Terminal
- Other terminal
- File
- Magtape
- TCP/IP
- DSM-DDP
- DTM-DCP
- System call
- Printer
Gets the name of an Internal table
Parameter: index - table index
Parameter: index - table index
- Pattern match
- Identifier
- Uppercase
- Lowercase
- Titlecase
- (reserved)
- (reserved)
- Accent
- Collation
- $X/$Y action
Converts an internal character set name to its preferred external name
Parameter:
Parameter:
- int - Internal charset name (eg: "Latin2")
- Preferred external name (eg: "ISO-8859-2")
- "" if there is no internal charset 'int'.
Inherited Members
Inherited Methods
- %AddToSaveSet()
- %ClassIsLatestVersion()
- %ClassName()
- %ConstructClone()
- %DispatchClassMethod()
- %DispatchGetModified()
- %DispatchGetProperty()
- %DispatchMethod()
- %DispatchSetModified()
- %DispatchSetMultidimProperty()
- %DispatchSetProperty()
- %Extends()
- %GetParameter()
- %IsA()
- %IsModified()
- %New()
- %NormalizeObject()
- %ObjectModified()
- %OriginalNamespace()
- %PackageName()
- %RemoveFromSaveSet()
- %SerializeObject()
- %SetModified()
- %ValidateObject()