Sub - Revision history

Ghenne at 19:22, 16 April 2026

2026-04-16T19:22:14Z

← Older revision		Revision as of 19:22, 16 April 2026
Line 6:		Line 6:

	== Description ==		== Description ==

			BASIC only. Use function for JavaScript.

	Sub declares a procedure, ''procdurename'', that executes statements, with ''arglist'' as parameters, with no return value. The required parameter, ''procedurename'', is used to call the procedure, and must follow standard variable naming conventions. The optional parameter list, ''arglist'', is a comma separated list of variables that are passed to the procedure when it is called. The optional component, ''statements'', will be executed as the body of the procedure. Any number of optional Exit Sub statements can be used to exit the procedure.		Sub declares a procedure, ''procdurename'', that executes statements, with ''arglist'' as parameters, with no return value. The required parameter, ''procedurename'', is used to call the procedure, and must follow standard variable naming conventions. The optional parameter list, ''arglist'', is a comma separated list of variables that are passed to the procedure when it is called. The optional component, ''statements'', will be executed as the body of the procedure. Any number of optional Exit Sub statements can be used to exit the procedure.
Line 15:		Line 17:
	To call a Sub, use the sub's name followed with parenthesis containing the arguments. If there are no arguments, it is still recommended that parenthesis be supplied, so it is clear that a Sub is being called.		To call a Sub, use the sub's name followed with parenthesis containing the arguments. If there are no arguments, it is still recommended that parenthesis be supplied, so it is clear that a Sub is being called.

	A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. ~~App Studio~~ treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.		A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. AppStudio treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.

	== Example ==		== Example ==
Line 22:		Line 24:
	Rem Sub Example		Rem Sub Example
	'Sub declares a procedure		'Sub declares a procedure

	Dim PriceA, PriceB		Dim PriceA, PriceB
	PrintMenu "Wednesday"		PrintMenu "Wednesday"
	PriceA = 53		PriceA = 53
	PriceB = 44		PriceB = 44
	~~Sort PriceA, PriceB~~		Print "Lowest Price:", mySort(PriceA, PriceB)
	Print "Lowest Price:", PriceA

	Sub PrintMenu(~~day~~)		Sub PrintMenu(Day)
	If ~~day~~ = "Wednesday" Then		If Day = "Wednesday" Then
	Print "Wednesday is Salisbury Steak day"		Print "Wednesday is Salisbury Steak day"
	End If		End If
	End Sub		End Sub

	~~Sub Sort~~(~~BYREF~~ x, ~~BYREF~~ y)		Function mySort(x, y)
	~~Dim Temp~~		Print x,y
	If x > y Then		If x < y Then
	~~Temp = y~~		Print "less"
	y = x		mySort = x
	~~x = Temp~~
	~~Exit Sub~~
	Else		Else
	~~Temp = x~~		Print "More", y
	x = y		mySort = y
	~~y = Temp~~
	End If		End If
	End ~~Sub~~		End Function
	</pre>		</pre>

Ghenne at 15:00, 28 April 2014

2014-04-28T15:00:24Z

← Older revision		Revision as of 15:00, 28 April 2014
Line 1:		Line 1:
	Sub ''procedurename''[(''arglist'')] <br />		Sub ''procedurename''(''arglist'') <br />
	:::[''statements''] <br />		:::[''statements''] <br />
	:::[Exit Sub] <br />		:::[Exit Sub] <br />

Ghenne: /* Description */

2014-04-28T15:00:01Z

Description

← Older revision		Revision as of 15:00, 28 April 2014
Line 12:		Line 12:

	A Function procedure will be called as a Sub procedure if the return value is not stored in a variable or used in an expression.		A Function procedure will be called as a Sub procedure if the return value is not stored in a variable or used in an expression.

			To call a Sub, use the sub's name followed with parenthesis containing the arguments. If there are no arguments, it is still recommended that parenthesis be supplied, so it is clear that a Sub is being called.

	A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. App Studio treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.		A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. App Studio treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.

Admin: /* Example */

2012-09-14T19:57:17Z

Example

← Older revision		Revision as of 19:57, 14 September 2012
Line 26:		Line 26:
	Sort PriceA, PriceB		Sort PriceA, PriceB
	Print "Lowest Price:", PriceA		Print "Lowest Price:", PriceA

	Sub PrintMenu(day)		Sub PrintMenu(day)
	If day = "Wednesday" Then		If day = "Wednesday" Then
Line 31:		Line 32:
	End If		End If
	End Sub		End Sub

	Sub Sort(BYREF x, BYREF y)		Sub Sort(BYREF x, BYREF y)
	Dim Temp		Dim Temp

Admin: /* Related Items */

2012-09-14T19:57:02Z

Ghenne at 12:51, 2 September 2012

2012-09-02T12:51:41Z

← Older revision		Revision as of 12:51, 2 September 2012
Line 13:		Line 13:
	A Function procedure will be called as a Sub procedure if the return value is not stored in a variable or used in an expression.		A Function procedure will be called as a Sub procedure if the return value is not stored in a variable or used in an expression.

	A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. ~~NS Basic/X~~ treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.		A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. App Studio treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.

	== Example ==		== Example ==

Brendon at 01:46, 24 August 2012

2012-08-24T01:46:52Z

← Older revision		Revision as of 01:46, 24 August 2012
Line 55:		Line 55:
	== Related Items ==		== Related Items ==

	[[call\|~~CALL~~]], [[function\|~~FUNCTION~~]]		[[call\|Call]], [[function\|Function]]

	[[Category:Language Reference]]		[[Category:Language Reference]]

Brendon at 03:42, 17 August 2012

2012-08-17T03:42:11Z

← Older revision		Revision as of 03:42, 17 August 2012
Line 1:		Line 1:
	~~SUB~~ ''procedurename''[(''arglist'')] <br />		Sub ''procedurename''[(''arglist'')] <br />
	:::[''statements''] <br />		:::[''statements''] <br />
	:::[~~EXIT SUB~~] <br />		:::[Exit Sub] <br />
	:::[''statements''] <br />		:::[''statements''] <br />
	~~END SUB~~		End Sub

	~~'''~~Description~~'''~~		== Description ==

	~~SUB~~ declares a procedure, ''procdurename'', that executes statements, with ''arglist'' as parameters, with no return value. The required parameter, ''procedurename'', is used to call the procedure, and must follow standard variable naming conventions. The optional parameter list, ''arglist'', is a comma separated list of variables that are passed to the procedure when it is called. The optional component, ''statements'', will be executed as the body of the procedure. Any number of optional ~~EXIT SUB~~ statements can be used to exit the procedure.		Sub declares a procedure, ''procdurename'', that executes statements, with ''arglist'' as parameters, with no return value. The required parameter, ''procedurename'', is used to call the procedure, and must follow standard variable naming conventions. The optional parameter list, ''arglist'', is a comma separated list of variables that are passed to the procedure when it is called. The optional component, ''statements'', will be executed as the body of the procedure. Any number of optional Exit Sub statements can be used to exit the procedure.

	Each member of ''arglist'' is an argument passed to the procedure. Simple variables, such as strings and numbers, are passed by value. Complex variables, such as arrays and objects, are passed by reference. Each member of ''arglist'' can be used within the procedure to reference a value passed in. It follows standard variable naming procedure.		Each member of ''arglist'' is an argument passed to the procedure. Simple variables, such as strings and numbers, are passed by value. Complex variables, such as arrays and objects, are passed by reference. Each member of ''arglist'' can be used within the procedure to reference a value passed in. It follows standard variable naming procedure.

	A ~~FUNCTION~~ procedure will be called as a ~~SUB~~ procedure if the return value is not stored in a variable or used in an expression.		A Function procedure will be called as a Sub procedure if the return value is not stored in a variable or used in an expression.

	A ~~SUB~~ procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. NS Basic/X treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.		A Sub procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. NS Basic/X treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.

	~~'''~~Example~~'''~~		== Example ==

	<pre>		<pre>
	~~REM SUB~~ Example		Rem Sub Example
	'~~SUB~~ declares a procedure		'Sub declares a procedure
	~~DIM~~ PriceA, PriceB		Dim PriceA, PriceB
	PrintMenu "Wednesday"		PrintMenu "Wednesday"
	PriceA = 53		PriceA = 53
	PriceB = 44		PriceB = 44
	Sort PriceA, PriceB		Sort PriceA, PriceB
	~~PRINT~~ "Lowest Price:", PriceA		Print "Lowest Price:", PriceA
	~~SUB~~ PrintMenu(day)		Sub PrintMenu(day)
	IF day = "Wednesday" ~~THEN~~		If day = "Wednesday" Then
	~~PRINT~~ "Wednesday is Salisbury Steak day"		Print "Wednesday is Salisbury Steak day"
	~~END IF~~		End If
	~~END SUB~~		End Sub
	~~SUB~~ Sort(BYREF x, BYREF y)		Sub Sort(BYREF x, BYREF y)
	~~DIM~~ Temp		Dim Temp
	IF x > y ~~THEN~~		If x > y Then
	Temp = y		Temp = y
	y = x		y = x
	x = Temp		x = Temp
	~~EXIT SUB~~		Exit Sub
	~~ELSE~~		Else
	Temp = x		Temp = x
	x = y		x = y
	y = Temp		y = Temp
	~~END IF~~		End If
	~~END SUB~~		End Sub
	</pre>		</pre>

	~~'''~~Output~~'''~~		== Output ==

	<pre>		<pre>
Line 53:		Line 53:
	</pre>		</pre>

	~~'''~~Related Items~~'''~~		== Related Items ==

	[[call\|CALL]], [[function\|FUNCTION]]		[[call\|CALL]], [[function\|FUNCTION]]

			[[Category:Language Reference]]

Brendon: Created page with "SUB ''procedurename''[(''arglist'')]
:::[''statements'']
:::[EXIT SUB]
:::[''statements'']
END SUB '''Description''' SUB declares a procedure, ''..."

2012-07-08T20:09:31Z

Created page with "SUB ''procedurename''[(''arglist'')] :::[''statements''] :::[EXIT SUB] :::[''statements''] END SUB '''Description''' SUB declares a procedure, ''..."

New page

SUB ''procedurename''[(''arglist'')] 
:::[''statements''] 
:::[EXIT SUB] 
:::[''statements''] 
END SUB

'''Description'''

SUB declares a procedure, ''procdurename'', that executes statements, with ''arglist'' as parameters, with no return value. The required parameter, ''procedurename'', is used to call the procedure, and must follow standard variable naming conventions. The optional parameter list, ''arglist'', is a comma separated list of variables that are passed to the procedure when it is called. The optional component, ''statements'', will be executed as the body of the procedure. Any number of optional EXIT SUB statements can be used to exit the procedure.

Each member of ''arglist'' is an argument passed to the procedure. Simple variables, such as strings and numbers, are passed by value. Complex variables, such as arrays and objects, are passed by reference. Each member of ''arglist'' can be used within the procedure to reference a value passed in. It follows standard variable naming procedure.

A FUNCTION procedure will be called as a SUB procedure if the return value is not stored in a variable or used in an expression.

A SUB procedure called with zero or one arguments may be called with empty parenthesis or the single argument in parenthesis. NS Basic/X treats a single expression enclosed in parenthesis as a single expression, not a one-element argument list.

'''Example'''

<pre>
REM SUB Example
'SUB declares a procedure
DIM PriceA, PriceB
PrintMenu "Wednesday"
PriceA = 53
PriceB = 44
Sort PriceA, PriceB
PRINT "Lowest Price:", PriceA
SUB PrintMenu(day)
IF day = "Wednesday" THEN
PRINT "Wednesday is Salisbury Steak day"
END IF
END SUB
SUB Sort(BYREF x, BYREF y)
DIM Temp
IF x > y THEN
Temp = y
y = x
x = Temp
EXIT SUB
ELSE
Temp = x
x = y
y = Temp
END IF
END SUB
</pre>

'''Output'''

<pre>
Wednesday is Salisbury Steak day
Lowest Price:44
</pre>

'''Related Items'''

[[call|CALL]], [[function|FUNCTION]]

← Older revision		Revision as of 19:57, 14 September 2012
Line 58:		Line 58:

	[[Category:Language Reference]]		[[Category:Language Reference]]

			[[Category:Statements - Flow of control]]