Save - Revision history

Laura: /* Technical Considerations */

2014-09-23T16:48:03Z

Technical Considerations

← Older revision		Revision as of 16:48, 23 September 2014
Line 46:		Line 46:

	The process of saving a file in source causes current STYLE formatting to be permanently save with the file. See [[STYLE]] in the [[BRConfig.sys]] chapter for additional information.		The process of saving a file in source causes current STYLE formatting to be permanently save with the file. See [[STYLE]] in the [[BRConfig.sys]] chapter for additional information.

			====BR STORAGE FORMAT====

			BR began using a new format for saving programs that allows for the expanded capacities in version 4.2. This format cannot be processed correctly with prior versions of BR. However, during development, to be able to make changes to 4.1 programs while one is running version 4.2 OPTION 60 provides a way to do this.

			Think of it as a mode setting. You are saving in 4.1 format or 4.2 format at any given point.

			OPTION 60 [ ON \| OFF ] ! saves programs in 4.1 loadable form

			If an attempt is made to store 4.2 only code in 4.1 format, an error
			is generated.

	<noinclude>		<noinclude>

Laura: /* Syntax */

2014-05-06T17:56:13Z

Syntax

← Older revision		Revision as of 17:56, 6 May 2014
Line 18:		Line 18:

	==Syntax==		==Syntax==
			SAVE [<file name>] [{OBJECT\|SOURCE}]

	[[Image:Save.png]]		[[Image:Save.png]]

Laura at 19:13, 7 August 2013

2013-08-07T19:13:14Z

← Older revision		Revision as of 19:13, 7 August 2013
Line 1:		Line 1:
	The '''Save (SA)''' command writes the [[program]] in memory to a new file.		The '''Save (SA)''' [[command]] writes the [[program]] in memory to a new file.

	==Comments and Examples==		==Comments and Examples==

Mikhail.zheleznov: edit

2011-12-26T16:32:52Z

edit

← Older revision		Revision as of 16:32, 26 December 2011
Line 28:		Line 28:
	==Parameters==		==Parameters==

	The "file name" parameter indicates the file name (and path, if necessary) of the new program. When you do not include an extension (or a period) with this file name, BR uses the extension .BR. The file name is required in most situations. However, if the file name already exists in memory but there is no existing file by that name (as sometimes occurs after a [[LOAD]][ SOURCE or [[FREE]] command), the file name need not be specified.		The "file name" parameter indicates the file name (and path, if necessary) of the new program. When you do not include an extension (or a period) with this file name, BR uses the extension .BR. The file name is required in most situations. However, if the file name already exists in memory but there is no existing file by that name (as sometimes occurs after a [[LOAD]] SOURCE or [[FREE]] command), the file name need not be specified.

	{\|		{\|
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|'''"OBJECT" '''\|\|optional parameter saves only the executable portion of the current program; when no extension is specified and no period is included, it appends .BRO. A .BRO (object) program no longer contains the source code, and cannot list most of the program lines; it retains only the DIM and DATA statements. This feature affords a high degree of program security. Be sure to save a copy of the source code before saving the file as an object file: .BRO files can be changed and replaced, but this is difficult to do without an accurate listing.		\|width="10%"\|'''OBJECT'''\|\|optional parameter saves only the executable portion of the current program; when no extension is specified and no period is included, it appends .BRO. A .BRO (object) program no longer contains the source code, and cannot list most of the program lines; it retains only the DIM and DATA statements. This feature affords a high degree of program security. Be sure to save a copy of the source code before saving the file as an object file: .BRO files can be changed and replaced, but this is difficult to do without an accurate listing.
	\|-valign="top"		\|-valign="top"
	\|}		\|}
Line 38:		Line 38:
	{\|		{\|
	\|-valign="top"		\|-valign="top"
	\|width="10%"\|'''"SOURCE" '''\|\|optional parameter saves the current program source data in display format; if no extension is specified and no period included in the file name, the system appends the extension .BRS.		\|width="10%"\|'''SOURCE'''\|\|optional parameter saves the current program source data in display format; if no extension is specified and no period included in the file name, the system appends the extension .BRS.
	\|-valign="top"		\|-valign="top"
	\|}		\|}


	==Technical Considerations==		==Technical Considerations==

Mikhail.zheleznov: edit

2011-12-26T16:32:05Z

edit

← Older revision		Revision as of 16:32, 26 December 2011
Line 1:		Line 1:
	~~Save (SA)~~		The '''Save (SA)''' command writes the [[program]] in memory to a new file.

	The '''Save (SA)''' [[command]] writes the [[program]] in memory to a new file.

	==Comments and Examples==		==Comments and Examples==
Line 7:		Line 5:
	Save works only for storing programs that do not currently exist as files. If you have loaded a stored program, made some changes to it, and want to store it under the same file name, you must either use the [[Replace]] command or you must [[Free]] the saved file before using Save.		Save works only for storing programs that do not currently exist as files. If you have loaded a stored program, made some changes to it, and want to store it under the same file name, you must either use the [[Replace]] command or you must [[Free]] the saved file before using Save.

	BR automatically appends a default extension to the file name when you use Save. To prevent this you must either specify a file name extension in the file~~-ref~~ or include a period at the end of the file name. The following example saves the file NAME.BR:		BR automatically appends a default extension to the file name when you use Save. To prevent this you must either specify a file name extension in the file name or include a period at the end of the file name. The following example saves the file NAME.BR:

	SAVE NAME		SAVE NAME
Line 30:		Line 28:
	==Parameters==		==Parameters==

	The "file~~-ref~~" parameter indicates the file name (and path, if necessary) of the new program. When you do not include an extension (or a period) with this file name, BR uses the extension .BR. The file name is required in most situations. However, if the file name already exists in memory but there is no existing file by that name (as sometimes occurs after a [[LOAD]][ SOURCE or [[FREE]] command), the file name need not be specified.		The "file name" parameter indicates the file name (and path, if necessary) of the new program. When you do not include an extension (or a period) with this file name, BR uses the extension .BR. The file name is required in most situations. However, if the file name already exists in memory but there is no existing file by that name (as sometimes occurs after a [[LOAD]][ SOURCE or [[FREE]] command), the file name need not be specified.

	{\|		{\|

Mikhail.zheleznov: Imported SAVE command page from old wiki

2011-12-26T16:30:49Z

Imported SAVE command page from old wiki

New page

Save (SA)

The '''Save (SA)''' [[command]] writes the [[program]] in memory to a new file.

==Comments and Examples==

Save works only for storing programs that do not currently exist as files. If you have loaded a stored program, made some changes to it, and want to store it under the same file name, you must either use the [[Replace]] command or you must [[Free]] the saved file before using Save.

BR automatically appends a default extension to the file name when you use Save. To prevent this you must either specify a file name extension in the file-ref or include a period at the end of the file name. The following example saves the file NAME.BR:

SAVE NAME

In contrast, the next example (which includes a period) saves the file NAME with no extension:

SAVE NAME.

The following example saves the current file under the name SAMPLE.BR on the disk in drive B:

SAVE B:SAMPLE

==Syntax==

[[Image:Save.png]]

==Defaults==

# Save the program under the known file name (file name must be in memory but cannot be an existing file).
# Save both source and object using the default extension .BR.

==Parameters==

The "file-ref" parameter indicates the file name (and path, if necessary) of the new program. When you do not include an extension (or a period) with this file name, BR uses the extension .BR. The file name is required in most situations. However, if the file name already exists in memory but there is no existing file by that name (as sometimes occurs after a [[LOAD]][ SOURCE or [[FREE]] command), the file name need not be specified.

{|
|-valign="top"
|width="10%"|'''"OBJECT" '''||optional parameter saves only the executable portion of the current program; when no extension is specified and no period is included, it appends .BRO. A .BRO (object) program no longer contains the source code, and cannot list most of the program lines; it retains only the DIM and DATA statements. This feature affords a high degree of program security. Be sure to save a copy of the source code before saving the file as an object file: .BRO files can be changed and replaced, but this is difficult to do without an accurate listing.
|-valign="top"
|}

{|
|-valign="top"
|width="10%"|'''"SOURCE" '''||optional parameter saves the current program source data in display format; if no extension is specified and no period included in the file name, the system appends the extension .BRS.
|-valign="top"
|}

==Technical Considerations==

The process of saving a file in source causes current STYLE formatting to be permanently save with the file. See [[STYLE]] in the [[BRConfig.sys]] chapter for additional information.

<noinclude>
[[Category:Commands]]
[[Category:Program Management Commands]]
</noinclude>