Cutting line portion - Revision history

Jsimlo at 14:36, 12 March 2014

2014-03-12T14:36:03Z

Jsimlo at 23:38, 20 November 2013

2013-11-20T23:38:21Z

Jsimlo at 22:47, 7 March 2012

2012-03-07T22:47:43Z

Jsimlo at 11:48, 1 August 2011

2011-08-01T11:48:47Z

Jsimlo at 21:44, 18 May 2011

2011-05-18T21:44:03Z

Jsimlo at 21:42, 18 May 2011

2011-05-18T21:42:50Z

Jsimlo at 21:34, 18 May 2011

2011-05-18T21:34:49Z

Jsimlo: Created page with '{{manversion|6.0.0.16}}NOTOC{{todo|Cutting line portion}}'

2011-05-07T21:49:51Z

Created page with '<noinclude>{{manversion|6.0.0.16}}__NOTOC__</noinclude>{{todo|Cutting line portion}}'

New page

<noinclude>{{manversion|6.0.0.16}}__NOTOC__</noinclude>{{todo|Cutting line portion}}

@@ Line 1: / Line 1: @@
 <noinclude>{{manversion|6.0.0.17}}__NOTOC__</noinclude>
 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}}.

@@ Line 14: / Line 14: @@
 *** four columns ({{string|HE}}, ''<nowiki>{empty}</nowiki>'', {{string|O&nbsp;WOR}} and {{string|D}}) &mdash; if delimited by an {{string|L}} character;
 **** but only three columns ({{string|HE}}, {{string|O&nbsp;WOR}} and {{string|D}}) &mdash; if {{field|Cutting line portion|Treat any sequence of delimiters as single delimiter}} option is turned on;
-*** and only one column ({{string|HELLO&nbsp;WORLD}}) &mdash; if delimited by an {{string|X}} character, {{defined|lowercase}} {{string|e}} character, or if delimited by no characters &mdash; this is because none of these characters are found on the examined line.
+*** and only one column ({{string|HELLO&nbsp;WORLD}}) &mdash; if delimited by an {{string|X}} character, {{defined|lower case}} {{string|e}} character, or if delimited by no characters &mdash; this is because none of these characters are found on the examined line.
 Note: {{defined|Columns}} are cut for each line separately, therefore the total number of {{defined|columns}} on a line may vary from line to line. If specified {{defined|column}} number is beyond the total number of {{defined|columns}}, empty zero-length portion is cut for such {{defined|column}} from that line. Therefore, it is allowed to cut {{defined|columns}} 2-7, even though some lines do not have enough {{defined|columns}} to offer.

@@ 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:
 * {{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 characters from {{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|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}}.

@@ Line 1: / Line 1: @@
-<noinclude>{{manversion|6.0.0.16}}__NOTOC__</noinclude>
+<noinclude>{{manversion|6.0.0.17}}__NOTOC__</noinclude>
 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}}.

@@ 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:
 * {{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|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}}.

@@ Line 9: / Line 9: @@
 ** Note: {{defined|Delimiters}} are not included within the {{defined|column}} being cut. However, if two or more subsequent {{defined|columns}} are cut together, inner {{defined|delimiters}} are not removed and become part of the line portion being cut.
 ** Note: {{field|Cutting line portion|Delimiting characters}} are always {{defined|case sensitive}}.
 Note: {{defined|Columns}} are cut for each line separately, therefore the total number of {{defined|columns}} on a line may vary from line to line. If specified {{defined|column}} number is beyond the total number of {{defined|columns}}, empty zero-length portion is cut for such {{defined|column}} from that line. Therefore, it is allowed to cut {{defined|columns}} 2-7, even though some lines do not have enough {{defined|columns}} to offer.
 After the first part (cutting {{defined|columns}} from the line), the resulting portion of the line can be further cropped by turning {{field|Cutting line portion|Use only characters}} option on, and specifying a range of character positions between {{field|Cutting line portion|from position}} and {{field|Cutting line portion|to position}}. This cuts off everyting before the {{field|Cutting line portion|from position}} and everyting after the {{field|Cutting line portion|to position}}.
 * {{field|Cutting line portion|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 {{defined|columns}} are cut. If a range is specified beyond cut {{defined|columns}}, empty zero-length portion is cropped from that line, even if the original line continues after the cut {{defined|columns}}. In other words, range of character positions cannot bring back what has already been cut off by previous step.
+Note: Range of character positions is always cropped after {{defined|columns}} are cut. If a range is specified beyond currently cut {{defined|columns}}, empty zero-length portion is cropped from that line, even if the original line continues after the cut {{defined|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 {{defined|columns}} after cropping a range of character positions.
 Note: {{button|Cutting line portion|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.

← Older revision		Revision as of 21:34, 18 May 2011
Line 1:		Line 1:
−	<noinclude>{{manversion\|6.0.0.16}}__NOTOC__</noinclude>{{todo\|Cutting line portion}}	+	<noinclude>{{manversion\|6.0.0.16}}__NOTOC__</noinclude>
		+	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\|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\|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}}.
		+	*** Note that even different delimiting characters are treated as a single indivisible {{defined\|delimiter}}, if found in sequence.
		+	** Optionally, {{field\|Cutting line portion\|Calculate columns backwards: from right to left}} can be used to numerate the {{defined\|columns}} from the end of line rather than the usual way. Note, however, that this only affects how the {{defined\|columns}} are numbered before they are cut; the text of the {{defined\|columns}} is not reversed.
		+	** Note: {{defined\|Delimiters}} are not included within the {{defined\|column}} being cut. However, if two or more subsequent {{defined\|columns}} are cut together, inner {{defined\|delimiters}} are not removed and become part of the line portion being cut.
		+	** Note: {{field\|Cutting line portion\|Delimiting characters}} are always {{defined\|case sensitive}}.
		+
		+	Note: {{defined\|Columns}} are cut for each line separately, therefore the total number of {{defined\|columns}} on a line may vary from line to line. If specified {{defined\|column}} number is beyond the total number of {{defined\|columns}}, empty zero-length portion is cut for such {{defined\|column}} from that line. Therefore, it is allowed to cut {{defined\|columns}} 2-7, even though some lines do not have enough {{defined\|columns}} to offer.
		+
		+	{{todo\|Cutting line portion}}
		+
		+	After the first part (cutting {{defined\|columns}} from the line), the resulting portion of the line can be further cropped by turning {{field\|Cutting line portion\|Use only characters}} option on, and specifying a range of character positions between {{field\|Cutting line portion\|from position}} and {{field\|Cutting line portion\|to position}}. This cuts off everyting before the {{field\|Cutting line portion\|from position}} and everyting after the {{field\|Cutting line portion\|to position}}.
		+	* {{field\|Cutting line portion\|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 {{defined\|columns}} are cut. If a range is specified beyond cut {{defined\|columns}}, empty zero-length portion is cropped from that line, even if the original line continues after the cut {{defined\|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 {{defined\|columns}} after cropping a range of character positions.
		+
		+	Note: {{button\|Cutting line portion\|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.
		+
		+	Example: A line {{string\|HELLO WORLD}} would be divided into:
		+	* two columns ({{string\|HELLO}} and {{string\|WORLD}}) — if delimited by a Space character;
		+	* four columns ({{string\|H}}, {{string\|LL}}, {{string\| W}} and {{string\|RLD}}) — if delimited by a set of {{string\|EO}} characters;
		+	* four columns ({{string\|HE}}, ''<nowiki>{empty}</nowiki>'', {{string\|O WOR}} and {{string\|D}}) — if delimited by an {{string\|L}} character;
		+	** but only three columns ({{string\|HE}}, {{string\|O WOR}} and {{string\|D}}) — if {{field\|Cutting line portion\|Treat any sequence of delimiters as single delimiter}} option is turned on;
		+	* and only one column ({{string\|HELLO WORLD}}) — if delimited by an {{string\|X}} character, {{defined\|lowercase}} {{string\|e}} character, or if delimited by no characters — this is because none of these characters are found on the examined line.