List - Revision history

Gordon.dye: Changed the word CLAUSES in the syntax statement.

2014-09-30T19:32:34Z

Changed the word CLAUSES in the syntax statement.

← Older revision		Revision as of 19:32, 30 September 2014
Line 47:		Line 47:

	==Syntax==		==Syntax==
	LIST [ [-]<[[line number]]>[-] ] [< <input file>] [<line number> [<line number>] [{~"<[[string]]>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [<[[ clause]]>] {[>[>]<output file>]\|[PRINT]}		LIST [ [-]<[[line number]]>[-] ] [< <input file>] [<line number> [<line number>] [{~"<[[string]]>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [ [[clause\|CLAUSES]] ] {[>[>]<output file>]\|[PRINT]}

	[[Image:List.png]]		[[Image:List.png]]

Laura: /* Syntax */

2014-05-08T17:00:07Z

Syntax

← Older revision		Revision as of 17:00, 8 May 2014
Line 47:		Line 47:

	==Syntax==		==Syntax==
	LIST [ [-]<[[line number]]>[-] ] [< <input file>] [<line number> [<line number>] [{~"<[[string]]>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [~~CLAUSE~~] {[>[>]<output file>]\|[PRINT]}		LIST [ [-]<[[line number]]>[-] ] [< <input file>] [<line number> [<line number>] [{~"<[[string]]>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [<[[ clause]]>] {[>[>]<output file>]\|[PRINT]}

	[[Image:List.png]]		[[Image:List.png]]

Laura: /* Parameters */

2014-05-08T16:58:43Z

Parameters

← Older revision		Revision as of 16:58, 8 May 2014
Line 60:		Line 60:

	==Parameters==		==Parameters==
	The word [[clause]] may be added to a list command to add identifiers as to where each clause begins and ends in each line listed.		The word [[ clause]] may be added to a list command to add identifiers as to where each clause begins and ends in each line listed.

	The LIST command requires no parameters. If you type LIST and press <ENTER>, the system will scroll through all of the program lines in memory.		The LIST command requires no parameters. If you type LIST and press <ENTER>, the system will scroll through all of the program lines in memory.

Laura: /* Syntax */

2014-05-08T16:57:28Z

Syntax

← Older revision		Revision as of 16:57, 8 May 2014
Line 47:		Line 47:

	==Syntax==		==Syntax==
	LIST [ [-]<line number>[-] ] [< <input file>] [<line number> [<line number>] [{~"<string>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [CLAUSE] {[>[>]<output file>]\|[PRINT]}		LIST [ [-]<[[line number]]>[-] ] [< <input file>] [<line number> [<line number>] [{~"<[[string]]>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [CLAUSE] {[>[>]<output file>]\|[PRINT]}

	[[Image:List.png]]		[[Image:List.png]]

Laura: /* Syntax */

2014-05-06T17:04:14Z

Syntax

← Older revision		Revision as of 17:04, 6 May 2014
Line 47:		Line 47:

	==Syntax==		==Syntax==
	LIST [ [-]<line number>[-] ] [< <input file>] [<line number> [<line number>]]		LIST [ [-]<line number>[-] ] [< <input file>] [<line number> [<line number>] [{~"<string>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [CLAUSE] {[>[>]<output file>]\|[PRINT]}
	~~[[Image:List.png]~~] [{~"<string>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [CLAUSE] {[>[>]<output file>]\|[PRINT]}
			[[Image:List.png]]

	==Defaults==		==Defaults==

Laura: /* Syntax */

2014-05-06T17:02:23Z

Syntax

← Older revision		Revision as of 17:02, 6 May 2014
Line 47:		Line 47:

	==Syntax==		==Syntax==
	[[Image:List.png]]		LIST [ [-]<line number>[-] ] [< <input file>] [<line number> [<line number>]]
			[[Image:List.png]] [{~"<string>"\|~'<string>'\|"<string>"\|'<string>'}][...3x] [REPLACE "<string>"] [CLAUSE] {[>[>]<output file>]\|[PRINT]}

	==Defaults==		==Defaults==

Laura at 21:12, 18 July 2013

2013-07-18T21:12:15Z

← Older revision		Revision as of 21:12, 18 July 2013
Line 1:		Line 1:

	<noinclude>		<noinclude>
	This article discusses the '''List''' [[command]]. For the List [[~~widget~~]] see [[Grid and List]].		This article discusses the '''List''' [[command]]. For the List [[GUI]] see [[Grid and List]].
	</noinclude>		</noinclude>

	The '''List (LIS)''' command searches for and displays some or all of the [[program lines]] according to one or more of the following options:		The '''List (LIS)''' command searches for and displays some or all of the program lines according to one or more of the following options:
	#A specific range of line references,		#A specific range of line references,
	#The presence or absence of specific case-insensitive strings,		#The presence or absence of specific case-insensitive strings,

Mikhail.zheleznov: format

2011-12-20T11:32:09Z

format

← Older revision		Revision as of 11:32, 20 December 2011
Line 98:		Line 98:

	==Technical Considerations==		==Technical Considerations==
	# LIST with the >~~file-ref~~ option is a useful way to record changes made to a program while it is in execution. Simply make the change, press <ENTER> to enter it, then list the changed line or program to a file. To use the newly saved file as a program, LOAD it from source.		# LIST with the '''>Redirected output File''' option is a useful way to record changes made to a program while it is in execution. Simply make the change, press <ENTER> to enter it, then list the changed line or program to a file. To use the newly saved file as a program, LOAD it from source.
	# The ability to scroll beyond the displayed lines can be discontinued by pressing the period (.) key immediately prior to pressing an up or down arrow key.		# The ability to scroll beyond the displayed lines can be discontinued by pressing the period (.) key immediately prior to pressing an up or down arrow key.

Mikhail.zheleznov: format

2011-12-20T11:27:09Z

format

← Older revision		Revision as of 11:27, 20 December 2011
Line 98:		Line 98:

	==Technical Considerations==		==Technical Considerations==
	# LIST with the >file-ref option is a useful way to record changes made to a program while it is in execution. Simply make the change, press <ENTER> to enter it, then list the changed line or program to a file. To use the newly saved		# LIST with the >file-ref option is a useful way to record changes made to a program while it is in execution. Simply make the change, press <ENTER> to enter it, then list the changed line or program to a file. To use the newly saved file as a program, LOAD it from source.
	file as a program, LOAD it from source.
	# The ability to scroll beyond the displayed lines can be discontinued by pressing the period (.) key immediately prior to pressing an up or down arrow key.		# The ability to scroll beyond the displayed lines can be discontinued by pressing the period (.) key immediately prior to pressing an up or down arrow key.

Mikhail.zheleznov: edit

2011-12-19T16:26:00Z

edit

← Older revision		Revision as of 16:26, 19 December 2011
Line 4:		Line 4:
	</noinclude>		</noinclude>

	The '''List (LIS)''' command searches for and displays some or all of the [[program lines]] according to one or more of the following options: a specific range of line references, ~~the~~ presence or absence of specific strings, ~~and the~~ presence or absence of specific case-sensitive strings. The string search capability of the LIST command additionally allows for string replacement.		The '''List (LIS)''' command searches for and displays some or all of the [[program lines]] according to one or more of the following options:
			#A specific range of line references,
			#The presence or absence of specific case-insensitive strings,
			#The presence or absence of specific case-sensitive strings.

			The string search capability of the LIST command additionally allows for string replacement.

	LIST supports two additional parameters: SKIP and -p. When used with LIST PRINT, SKIP will prevent the form feed from occurring at the end of printing. The -p parameter will output one line at a time when LIST is used to search for or replace a program string.		LIST supports two additional parameters: SKIP and -p. When used with LIST PRINT, SKIP will prevent the form feed from occurring at the end of printing. The -p parameter will output one line at a time when LIST is used to search for or replace a program string.
Line 19:		Line 24:
	LIST 350- PRINT		LIST 350- PRINT

	The following example sends lines 500-1350 to the ~~newly created~~ file OUTPUT.BRS on the disk in drive B:		The following example sends lines 500-1350 to the file OUTPUT.BRS, which gets created by this command on the disk in drive B:

	LIST 500 1350 >B:\OUTPUT.BRS		LIST 500 1350 >B:\OUTPUT.BRS

	The next example lists all program lines containing the two strings "OPEN" and "DISPLAY", but not containing the string 'srow'.		The next example lists all program lines containing the two strings "OPEN" and "DISPLAY", but not containing the string 'srow'. '''Note that single quotation marks have a different meaning than double quotation marks with the LIST command: single quotation marks indicate that uppercase or lowercase matches are to be accepted, while double quotes indicate that only an exact case match should be accepted.'''

	'''Note that single quotation marks have a different meaning than double quotation marks with the LIST command: single quotation marks indicate that uppercase or lowercase matches are to be accepted, while double quotes indicate that only an exact case match should be accepted.'''

	LIST "OPEN" "DISPLAY" ~'srow'		LIST "OPEN" "DISPLAY" ~'srow'
Line 59:		Line 62:
	The LIST command requires no parameters. If you type LIST and press <ENTER>, the system will scroll through all of the program lines in memory.		The LIST command requires no parameters. If you type LIST and press <ENTER>, the system will scroll through all of the program lines in memory.

	There are two main paths through the syntax diagram. The top path allows you to list a full screen of program lines that either start or end with the specified "line~~-ref"~~. The "line~~-ref"~~ may be either a line number or a line label. Use a dash (-), either before or after a line reference, to view the specified line and a screen of lines above or below it.		There are two main paths through the syntax diagram. The top path allows you to list a full screen of program lines that either start or end with the specified '''line number'''. The '''line number''' may be either a line number or a line label. Use a dash (-), either before or after a line reference, to view the specified line and a screen of lines above or below it.

			The bottom path through the diagram provides you with several alternatives.

			The '''redirected input file''' parameter may be used with the LIST command instead of a program loaded in memory.

			LIST <SOMEPROGRAM.BR "INVOICE"

			The '''from line number''' parameter allows listing of lines from any .BR file. The program in memory is unchanged by input file redirection.

	The ~~second path through~~ the ~~diagram provides you with several alternatives. The "~~from ~~file-ref" parameter allows listing of~~ lines ~~from any .BR file. The program in memory is unchanged by input file redirection~~.		The '''from line number''' and '''to line number''' parameters specify the starting and ending line numbers or labels from which lines should be displayed.

	~~The "from line-ref" and "to line-ref" parameters specify the starting and ending line numbers or labels from which lines should be displayed~~.		From this point, there are three options.

	~~From this point, there are three options.~~ The top option allows you to specify up to three "string" parameters. BR will display all lines which either do or do not contain the specified string according to whether the not operator (~) is used. Any combination of strings with or without the not operator may be specified. Single quotes represent case insensitive while double quotes represent case sensitive matching.		The top option allows you to specify up to three "string" parameters. BR will display all lines which either do or do not contain the specified string according to whether the '''not''' operator '''~''' is used. Any combination of strings with or without the not operator may be specified. Single quotes represent case insensitive while double quotes represent case sensitive matching.

	The middle option allows you to specify a search and replace operation. The quotation marks and "string" parameter operate in the same manner described above. The "REPLACE" keyword and the string that is to replace the current string must follow. BR will locate all lines that contain a match, replace the specified strings and display the new lines. The lines will not become permanent unless you scroll back up to each one and enter it by pressing <ENTER>.		The middle option allows you to specify a search and replace operation. The quotation marks and "string" parameter operate in the same manner described above. The '''REPLACE''' keyword and the string that is to replace the current string must follow. BR will locate all lines that contain a match, replace the specified strings and display the new lines. The lines will not become permanent unless you scroll back up to each one and enter it by pressing <ENTER>.

	The bottom option is the default. When no strings are specified, BR lists all specified lines.		The bottom option is the default. When no strings are specified, BR lists all specified lines.

	~~"To file-ref" redirects~~ the ~~specified lines~~ to a ~~display~~ file.		'''>Redirected output File''' saves directory information that would normally be displayed on the screen to a text file.
			'''>>Redirected output File''' appends directory information to an existing text file.

	"PRINT" redirects output to a printer. It is important to note that the redirected output differs from the screen output: whereas the screen displays just one line when a single line number is indicated, PRINT prints all lines from the start of a specified program to the end of the program.		'''PRINT''' redirects output to a printer. It is important to note that the redirected output differs from the screen output: whereas the screen displays just one line when a single line number is indicated, PRINT prints all lines from the start of a specified program to the end of the program.

	LIST PRINT now utilizes printer initialization escape sequences.		LIST PRINT now utilizes printer initialization escape sequences.
Line 79:		Line 91:
	LIST -P now works under a broader range of conditions, including input redirection.		LIST -P now works under a broader range of conditions, including input redirection.

	~~For example:~~LIST <TEMP -P		LIST <TEMP -P

	When the LIST command's -P parameter is used, a digit (1-9) is now accepted from the keyboard after the first scroll (and on subsequent scrolls) to identify the number of additional lines to scroll. Pressing <ENTER> still causes a single line to scroll.		When the LIST command's -P parameter is used, a digit (1-9) is now accepted from the keyboard after the first scroll (and on subsequent scrolls) to identify the number of additional lines to scroll. Pressing <ENTER> still causes a single line to scroll.