Difference between revisions of "Cutting line portion"

From TED Notepad
Line 2: Line 2:
 
Cutting portion of a {{defined|line}} is divided into two successive parts. First, {{defined|columns}} are cut from the {{defined|line}}, by either:
 
Cutting portion of a {{defined|line}} is divided into two successive parts. First, {{defined|columns}} are cut from the {{defined|line}}, by either:
 
* {{field|Cutting line portion|Entire line}}, which keeps the entire original {{defined|line}}.
 
* {{field|Cutting line portion|Entire line}}, which keeps the entire original {{defined|line}}.
* {{field|Cutting line portion|Columns}}, which allows to specify one or more subsequent {{defined|columns}} between {{field|Cutting line portion|Columns from}} and {{field|Cutting line portion|Columns to}} (inclusive). Individual {{defined|columns}} are separated by {{field|Cutting line portion|Delimiting characters}}, which means that the {{defined|line}} is scanned for these {{defined|delimiting characters}}, and wherever a {{defined|delimiting character}} is found (any character from {{field|Cutting line portion|Delimiting characters}}), old {{defined|column}} ends before this {{defined|delimiter}} and a new {{defined|column}} begins after this {{defined|delimiter}}. There can be as many {{defined|delimiting characters}} as necessary and all of them delimit {{defined|columns}} equally and indiscriminately.
+
* {{field|Cutting line portion|Columns}}, which allows to specify one or more subsequent {{defined|columns}} between {{field|Cutting line portion|columns from}} and {{field|Cutting line portion|columns to}} (inclusive). Individual {{defined|columns}} are separated by {{field|Cutting line portion|Delimiting characters}}, which means that the {{defined|line}} is scanned for these {{defined|delimiting characters}}, and wherever a {{defined|delimiting character}} is found (any character from {{field|Cutting line portion|Delimiting characters}}), old {{defined|column}} ends before this {{defined|delimiter}} and a new {{defined|column}} begins after this {{defined|delimiter}}. There can be as many {{defined|delimiting characters}} as necessary and all of them delimit {{defined|columns}} equally and indiscriminately.
 
** Optionally, {{field|Cutting line portion|Delimit by entire phrase rather than separate characters}} can be used to stop treating {{field|Cutting line portion|Delimiting characters}} as a set of individual characters, and scan for an entire {{defined|delimiting phrase}} instead.
 
** Optionally, {{field|Cutting line portion|Delimit by entire phrase rather than separate characters}} can be used to stop treating {{field|Cutting line portion|Delimiting characters}} as a set of individual characters, and scan for an entire {{defined|delimiting phrase}} instead.
 
** Optionally, {{field|Cutting line portion|Treat any sequence of delimiters as single delimiter}} can be used to count several successive {{defined|delimiters}} as a single {{defined|delimiter}}. This can be useful, for example, if input {{defined|columns}} are aligned by spaces into neat visual columns, where each two {{defined|columns}} are delimited by an arbitrary-length sequence of spaces. Such sequences need to be treated as indivisible column {{defined|delimiters}}.
 
** Optionally, {{field|Cutting line portion|Treat any sequence of delimiters as single delimiter}} can be used to count several successive {{defined|delimiters}} as a single {{defined|delimiter}}. This can be useful, for example, if input {{defined|columns}} are aligned by spaces into neat visual columns, where each two {{defined|columns}} are delimited by an arbitrary-length sequence of spaces. Such sequences need to be treated as indivisible column {{defined|delimiters}}.

Revision as of 21:44, 18 May 2011

This section is up to date for TED Notepad version 6.3.1.0.

Cutting portion of a line is divided into two successive parts. First, columns are cut from the line, by either:

Note: Columns are cut for each line separately, therefore the total number of columns on a line may vary from line to line. If specified column number is beyond the total number of columns, empty zero-length portion is cut for such column from that line. Therefore, it is allowed to cut columns 2-7, even though some lines do not have enough columns to offer.

After the first part (cutting columns from the line), the resulting portion of the line can be further cropped by turning Use only characters option on, and specifying a range of character positions between from position and to position. This cuts off everyting before the from position and everyting after the to position.

  • Calculate the position backwards: from right to left can be used to numerate the character positions from the end of line rather than the usual way. Note, however, that this only affects how the positions are numbered before they are cropped; the text itself is not reversed.

Note: Range of character positions is always cropped after columns are cut. If a range is specified beyond currently cut columns, empty zero-length portion is cropped from that line, even if the original line continues after the cut columns. In other words, range of character positions cannot bring back what has already been cut off by previous step.

Note: There is currently no way to cut columns after cropping a range of character positions.

Note: Column preview button displays a small portion of lines transformed by current dialog values. Be aware that preview is always generated from the current selection. If there is no selection, then there is nothing to preview.