Procedure Declaration

When the ooPIC is initially powered on, or has just encountered a reset, the Program Flow will start execution with the Main Procedure named "main".

Sub <procedurename>(<arglist>)
  <statements>
  [Exit Sub]
  <statements>
End Sub

sub void <procedurename>(<arglist>){
  <statements>
  [return;]
  <statements>
}

The following table lists the elements of the Procedure Construct syntax.

The following shows the format of the <arglist> element.

([<id1> As <type1>[, <idX> As <typeX>[,...]]])

([<type1> <id1>[, <typeX> <idx>[,...]]][void])

The following table lists the elements of the <arglist> format.

Basic Syntax:
When a Procedure Call is encountered during the program's execution, any values specified in the <arglist> element are copied to the values used by the Procedure specified by the <procedurename> element, the current program flow position is saved and the program flow branches to the Procedure  

After branching to the Procedure, the program flow executes the statements within the Procedure until either the end of the Procedure or the Exit Sub keywords are encountered, at which time the original program flow position is retrieved and the program flow execution resumes at its original position.

C Syntax:
Note: In C, Procedures are called Functions, even though they do not return a value.
When a Function's identifier, specified by the <procedurename> element, is encountered during the program's execution, any values specified by the <arglist> element are copied to the values used by the Function, the current program flow position is saved and the program flow branches to the specified Function.

After branching to the Function, the program flow executes the statements within the Function until the end of the Function is encountered, at which time the original program flow position is retrieved and the program execution resumes at its original position.

Java Syntax:
Note: In Java, Procedures are called methods due to their encapsulation within a Class.
When a Method's identifier, specified by the <procedurename> element, is encountered during the program's execution, any values specified by the <arglist> element are copied to the values used by the Method, the current program flow position is and the program flow branches to the specified Method.

After branching to the Method, the program flow executes the statements within the Method until the end of the Method is encountered, at which time the original program flow position is retrieved and the program executions resumes at its original position.

Dim A As New oDIO1

Sub Main()
  A.IOLine = 31
  A.Direction = cvOutput
  Call Blink
  Call Blink
End Sub

Sub Blink() 
  A.Value = cvOn
  ooPIC.Delay = 100
  A.Value = cvOff
  ooPIC.Delay = 100
End Sub

oDIO1 A = New oDIO1;

Sub Void main(Void){
  A.IOLine = 31;
  A.Direction = cvOutput;
  Blink;
  Blink;
}

Sub Void Blink(Void){ 
  A.Value = cvOn;
  ooPIC.Delay = 100;
  A.Value = cvOff;
  ooPIC.Delay = 100;
}

A As oDIO1(31,cvOutput)
Call Blink
Call Blink

Sub Blink() 
  A.Value = cvOn
  ooPIC.Delay = 100
  A.Value = cvOff
  ooPIC.Delay = 100
End Sub

In the following example, a program is shown that branches to, and returns from, a procedure named "Blink" once, but passes an argument of 5, which is used by the procedure to determine how many times to blink.

Visual Basic	C & Java
Dim A As New oDIO1 Sub Main() A.IOLine = 31 A.Direction = cvOutput Call Blink(5) End Sub Sub Blink(xTimes As Byte) While xTimes.Value > 0 A.Value = cvOn ooPIC.Delay = 100 A.Value = cvOff ooPIC.Delay = 100 xTimes = xTimes - 1 Wend End Sub	oDIO1 A = New oDIO1; Sub Void main(Void){ A.IOLine = 31; A.Direction = cvOutput; Blink(5); } Sub Void Blink(Byte xTimes){ While (xTimes.Value > 0){ A.Value = cvOn; ooPIC.Delay = 100; A.Value = cvOff; ooPIC.Delay = 100; xTimes = xTimes - 1; } }
BASIC
Dim A As New oDIO1(31,cvOutput) Call Blink(5) Sub Blink(xTimes As Byte) While xTimes.Value > 0 A.Value = cvOn ooPIC.Delay = 100 A.Value = cvOff ooPIC.Delay = 100 xTimes = xTimes - 1 Wend End Sub

The following example shows a Procedure Call that passes two arguments to a procedure named "Fred". The first argument is a constant of 5, and the second argument is the value of A.

Visual Basic & BASIC	C & Java
Call Fred(5, A.Value)	Blink(5, A.Value);

Bugs: No known bugs.