Home > Class Reference > ENSLIB namespace > %SYS.NLS.Device

%SYS.NLS.Device

class %SYS.NLS.Device extends %Library.RegisteredObject

Exposes some NLS properties of the current device.

Changing a property acts immediately on the current device, not on the device that was current when the object was instantiated.

For generic locale properties see %SYS.NLS.Locale.
For system and process NLS table settings see %SYS.NLS.Table.
For date, time and number format properties see %SYS.NLS.Format.

Property Inventory (Including Private)

Method Inventory (Including Private)

Properties (Including Private)

property InpDefaultAction as %Integer;
Input default action
  • 0 = generate error
  • 1 = replace with replacement value/string
  • 2 = ignore (replace with original character)
Property methods: InpDefaultActionDisplayToLogical(), InpDefaultActionGet(), InpDefaultActionIsValid(), InpDefaultActionLogicalToDisplay(), InpDefaultActionNormalize(), InpDefaultActionSet()
property InpReplaced as %Boolean;
If true indicates that a replacement occurred during the last input translation.
Property methods: InpReplacedDisplayToLogical(), InpReplacedGet(), InpReplacedIsValid(), InpReplacedLogicalToDisplay(), InpReplacedNormalize(), InpReplacedSet()
property InpReplacementValue as %String;
Input replacement value/string.
Substituted in case of error if InpDefaultAction=1
Property methods: InpReplacementValueDisplayToLogical(), InpReplacementValueGet(), InpReplacementValueIsValid(), InpReplacementValueLogicalToDisplay(), InpReplacementValueLogicalToOdbc(), InpReplacementValueNormalize(), InpReplacementValueSet()
property OutDefaultAction as %Integer;
Output default action
  • 0 = generate error
  • 1 = replace with replacement value/string
  • 2 = ignore (replace with original character)
Property methods: OutDefaultActionDisplayToLogical(), OutDefaultActionGet(), OutDefaultActionIsValid(), OutDefaultActionLogicalToDisplay(), OutDefaultActionNormalize(), OutDefaultActionSet()
property OutReplaced as %Boolean;
If true indicates that a replacement occurred during the last output translation.
Property methods: OutReplacedDisplayToLogical(), OutReplacedGet(), OutReplacedIsValid(), OutReplacedLogicalToDisplay(), OutReplacedNormalize(), OutReplacedSet()
property OutReplacementValue as %String;
Output replacement value/string.
Substituted in case of error if OutDefaultAction=1
Property methods: OutReplacementValueDisplayToLogical(), OutReplacementValueGet(), OutReplacementValueIsValid(), OutReplacementValueLogicalToDisplay(), OutReplacementValueLogicalToOdbc(), OutReplacementValueNormalize(), OutReplacementValueSet()
property Pitch as %Integer;
Used with double width characters (e.g. Kanji)
Property methods: PitchDisplayToLogical(), PitchGet(), PitchIsValid(), PitchLogicalToDisplay(), PitchNormalize(), PitchSet()
property State as %Boolean;
State of translation for current device
  • 0 = Off
  • 1 = On
Property methods: StateDisplayToLogical(), StateGet(), StateIsValid(), StateLogicalToDisplay(), StateNormalize(), StateSet()
property XLTTable as %String;
Translation table associated with current device.
Property methods: XLTTableDisplayToLogical(), XLTTableGet(), XLTTableIsValid(), XLTTableLogicalToDisplay(), XLTTableLogicalToOdbc(), XLTTableNormalize(), XLTTableSet()

Methods (Including Private)

method InpModeStrGetAt(mode As %Integer) as %String
Get input mode string
Parameters:
  • mode - mode number
Returns: current input string for given mode or "" in case of error
method InpModeStrSetAt(value As %String, mode As %Integer) as %String
Set input mode string
Parameters:
  • value - new input mode string
  • mode - mode number
Returns: previous input string for given mode or "" in case of error
method OutModeStrGetAt(mode As %Integer) as %String
Get output mode string
Parameters:
  • mode - mode number
Returns: current output string for given mode or "" in case of error
method OutModeStrSetAt(value As %String, mode As %Integer) as %String
Set output mode string
Parameters:
  • value - new output mode string
  • mode - mode number
Returns: previous output string for given mode or "" in case of error
classmethod SetIO(tabnam As %String) as %String
Sets I/O translation table for current device

This method exists as a convenience only. Calling it is equivalent to instantiating a %SYS.NLS.Device object and setting obj.XLTTable=tabnam

Parameters:
  • tabnam - table name
Returns: previous table or "" in case of error

Inherited Members

Inherited Methods (Including Private)