Differences

This shows you the differences between two versions of the page.

--- mpl [2016/07/11 16:28] – [CASE Statements] gryphon
+++ mpl [2016/07/13 21:27] (current) – g00r00
@@ Line 23: / Line 23: @@
 ==== Comments ====
 All text after a two slashes (⁄⁄) is considered a comment.  It will be ignored until the next line of code.  For example:
   WriteLn ('Hello There')  ⁄⁄ This is a comment and will be ignored.
@@ Line 52: / Line 53: @@
   Const
-  UserDeleted = $04;  // established bit for userdeleted from records.pas
+    UserDeleted = $00000004;  // Deleted bit from records.pas
-                      // note: this value has changed check records.pas!
   Begin
-    GetThisUser
+    GetThisUser;
     If UserFlags AND UserDeleted <> 0 Then
       WriteLn('User is deleted');
-    End;
+  End;
 ==== Defining Variables ====
 All variables are global to all of the program, including procedures.  The syntax for declaring a variable follows:
-  Var <VarName> : <VarType>
+  Var <Variable Name> : <Variable Type>
   Examples:
-  var dummy : byte
+  Var Dummy : Byte;
-  var str   : string
+  Var Str   : String;
-  var
+  Var
-    dummy : byte,
+    Dummy1,
-    str   : string
+    Dummy2  : Byte;
 The following variable types are supported:
@@ Line 86: / Line 87: @@
   Word            Numerical      0..65535
   LongInt         Numerical      -2147483648..214748364
+  Cardinal        Numerical      0..4294967295
   Real            Numerical      9.99
-All variables except ARRAYs can be initialized when when defined.
+All variables except ARRAYs can be initialized when when defined:
   Var TotalBases : LongInt = GetMBaseTotal(False)
@@ Line 96: / Line 98: @@
 ARRAY multi-dimensional variables are supported.  The syntax for declaring an array variable is:
-  Var <VarName> :  ARRAY[<Low>..<High>] of <VarType>
+  Var <VarName> : ARRAY[<Low>..<High>] of <VarType>
-  Var <VarName> :  ARRAY[<L>..<H>, <L>..<H>] of <VarType>
+  Var <VarName> : ARRAY[<L>..<H>, <L>..<H>] of <VarType>
-  Var <VarName> :  ARRAY[<L>..<H>, <L>..<H>, <L>..<H>] of <VarType>
+  Var <VarName> : ARRAY[<L>..<H>, <L>..<H>, <L>..<H>] of <VarType>
 Examples:
-  Var Dummy : Array[1..10] of Byte
+  Var Dummy : Array[1..10] of Byte;
-  Var Str   : Array[5..10] of String
+  Var Str   : Array[5..10] of String;
-  Var Int   : Array[1..10,1..10,1..10] of Integer
+  Var Int   : Array[1..10, 1..10, 1..10] of Integer;
-HEXIDECIMAL values are supported.  They can be used in numeric variable assignment numerical evaluation, and in numeric constant variables.  A hex value must begin with a $ character.
+HEXIDECIMAL values are supported.  They can be used in numeric variable assignment numerical evaluation, and in numeric constant variables.  A hex value must begin with a $ character:
-Some examples:
   Const
     MyHexValue = $1F;
-    Value := $10;
+  Value := $10;
-  If Value = $10 Then WriteLn('Value is 16 <in decimal>');
+  If Value = $10 Then
+    WriteLn('Value is 16 <in decimal>');
 ==== Record Structures ====
@@ Line 288: / Line 290: @@
 ==== FUNCTIONS ====
+The syntax for defining a function is as follows:
+  Function <Function Name> (<varname vartype>) : <result type>
+IE:
+  Function AddTen (Num Byte) : Byte
+  Begin
+    AddTen := Num + 10
+  End
+==== CONST VARIABLES ====
+The syntax for a constant variable is as follows:
+String constants:
+  Const
+    SomeStr = 'Hello World!'
+Numerical constants:
+  Const
+    SomeNum = 69
+Constant variables, like regular variables, can be separated with a comma:
+  Const
+    SomeNum = 69,
+    SomeStr = 'Hello World!'
+At the moment, constant variables cannot be used in certain places within the MPE engine.  If you are assigning a value to a variable, constant values will not be recognized.