useSourceColumns parameter

Use the useSourceColumns parameter to set or query whether the editor uses column characteristics of the file in its source character encoding.

Availability

query command
set command
current parameter
default parameter
install parameter

Scope

useSourceColumns is scoped to the current document.
current.useSourceColumns is scoped to the current document.
default.useSourceColumns is globally scoped.
install.useSourceColumns is globally scoped.

Syntax

query useSourceColumns
set useSourceColumns [ default | on | off ]
query current.useSourceColumns
query default.useSourceColumns
set default.useSourceColumns [ install | on | off ]
query install.useSourceColumns 

Parameters

default If you specify the default parameter for the set useSourceColumns command, the current document will use the value of default.useSourceColumns.
on If you specify the on parameter for the set useSourceColumns command, the current document will use column characteristics of the file in its source encoding.  If you specify the on parameter for the set default.useSourceColumns command, all documents that have useSourceColumns set to default will use column characteristics of the file in its source encoding.
off If you specify the off parameter for the set useSourceColumns command, the current document will use column characteristics of the file in its Unicode encoding.  If you specify the off parameter for the set default.useSourceColumns command, all documents that have useSourceColumns set to default will use column characteristics of the files in their Unicode encoding.
install If you specify the install parameter for the set default.useSourceColumns command, all of the documents that have useSourceColumns set to default will use the value of install.useSourceColumns.

Description

By default, text length and column-related editor settings are in terms of Unicode characters.  The useSourceColumns parameter allows you to change this to bytes, in order to better emulate the editing of remote files in their native environment.  This parameter is effective only for documents with any of these settings:

The following editor settings and features may be affected by the value of the useSourceColumns parameter:

If you do not specify any of the parameters for the set useSourceColumns command, default is assumed.  If you do not specify any of the parameters for the set default.useSourceColumns command, install is assumed.

The query current.useSourceColumns command returns on if the current view uses column characteristics of the file in its source encoding or off if the current view uses column characteristics of the file in its Unicode encoding.

Examples

query useSourceColumns
set useSourceColumns off
query current.useSourceColumns
query default.useSourceColumns
set default.useSourceColumns off
query install.useSourceColumns 

Related reference
query command
set command
current parameter
default parameter
install parameter
displayPosition parameter
expandTabs parameter
fields parameter
save.textLimit parameter
sequenceNumbers parameter
sourceCcsid parameter
sourceEncoding parameter