Introduction to SourcePawn 1.7 - Revision history

Asherkin: No such thing as an unsigned left shift

2021-10-07T23:22:17Z

No such thing as an unsigned left shift

2021-10-07T22:49:17Z

‎Operators: Include logical shift operators

2021-08-15T15:54:37Z

Add example for {x, ...} Syntax

2021-07-23T16:57:08Z

Fixed a typo

2021-07-19T21:19:03Z

"sub-arrays" are formally known as slices

2021-06-21T06:31:51Z

‎Declaration: Update syntax

2020-05-28T03:46:18Z

Replace any[] for any (arrays not introduced at this stage). Remove inaccurate information

2020-05-21T22:08:33Z

2020-03-30T03:13:37Z

Fix syntax for dynamic array function parameter

2020-03-30T03:08:25Z

‎Array Parameters: Updated syntax

@@ Line 451: / Line 451: @@
 This is true of the following operators in Pawn:
 *Four-function: *, /, -, +
-*Bit-wise: |, &, ^, ~, <<, >>, <<<, >>>
+*Bit-wise: |, &, ^, ~, <<, >>, >>>
 Additionally, there are increment/decrement operators:

@@ Line 451: / Line 451: @@
 This is true of the following operators in Pawn:
 *Four-function: *, /, -, +
-*Bit-wise: |, &, ^, ~, <<, >>
+*Bit-wise: |, &, ^, ~, <<, >>, <<<, >>>
 Additionally, there are increment/decrement operators:

@@ Line 127: / Line 127: @@
 int numbers[5] = {1, 2, 3, 4, 5};       // Stores 1, 2, 3, 4, 5.
 float origin[3] = {1.0, 2.0, 3.0};      // Stores 1.0, 2.0, 3.0.
 </sourcepawn>

@@ Line 14: / Line 14: @@
 There a few important constructs you should know before you begin to script. The first is a '''variable'''. A variable is a symbol, or name, that holds data. For example, the variable "a" could hold the number "2", "16", "0", et cetera. Since a variable holds data, it also allocates the memory needed to store that data.
-In addition to a name, variables have a '''type'''. A type tells the program how to interpret the data, and how much memory the data will use. Pawn has three types of data that are most commonly used:
+In addition to a name, variables have a '''type'''. A type tells the program how to interpret the data, and how much memory the data will use. Pawn has four types of data that are most commonly used:
 * Integers, using the <tt>int</tt> type. Integer types may store a whole number from -2147483648 to 2147483647.
 * Floats, using the <tt>float</tt> type. Float types may store fractional numbers in a huge range, though they are not as precise as integers.

@@ Line 380: / Line 380: @@
 It is a good idea to use <tt>const</tt> in array parameters if you know the array won't be modified; this can prevent coding mistakes.
-When a function takes an array as a parameter, you can also pass any indexed array element which will be interpreted as a sub-array that begins from that index. For example,
+When a function takes an array as a parameter, you can also pass any indexed array element which will be interpreted as a sub-array (slice) that begins from that index. For example,
 if you want to get the length of a string, you can use the strlen function like so:
@@ Line 388: / Line 388: @@
 </sourcepawn>
-And if you pass an indexed array element, it will be interpreted as a sub-array that begins from that index like so:
+And if you pass an indexed array element, it will be interpreted as a slice that begins from that index like so:
 <sourcepawn>

@@ Line 316: / Line 316: @@
 ChangeValue(a);
-ChangeValue(b)
+void ChangeValue(int b)
+{
     b = 5;

@@ Line 24: / Line 24: @@
 <sourcepawn>int money = 5400;
 float percent = 67.3;
-char message[64] = "Hello";
+char key = 'A';
 bool enabled = false;
 </sourcepawn>
 ==Functions==
-The next important concept is '''functions'''. Functions are symbols or names that perform an action. When you invoke, or call them, they carry out a specific sequence of code and then return a result. But keep in mind that you cannot return an array as result from a function. There are a few types of functions, but every function is activated the same way. Example:
+The next important concept is '''functions'''. Functions are symbols or names that perform an action. When you invoke, or call them, they carry out a specific sequence of code and then return a result. There are a few types of functions, but every function is activated the same way. Example:
 <sourcepawn>

@@ Line 633: / Line 633: @@
 int sum = SumArray(array, 10);
-int SumArray(const int array[], int count)
+int SumArray(const int[] array, int count)
+{
     int total;
@@ Line 677: / Line 677: @@
 Here is the previous for loop rewritten as a while loop:
 <sourcepawn>
-int SumArray(const int array[], int count)
+int SumArray(const int[] array, int count)
+{
     int total, i;
@@ Line 710: / Line 710: @@
   * Returns the array index where the value is, or -1 if not found.
   */
-int SearchInArray(const int array[], int count, int value)
+int SearchInArray(const int[] array, int count, int value)
+{
     int index = -1;
@@ Line 730: / Line 730: @@
 Similarly, the <tt>continue</tt> keyword skips an iteration of a loop. For example, let's say we wanted to sum all even numbers:
 <sourcepawn>
-int SumEvenNumbers(const int array[], int count)
+int SumEvenNumbers(const int[] array, int count)
+{
     int sum;

@@ Line 372: / Line 372: @@
 To prevent an array from being modified in a function, you can mark it as <tt>const</tt>. This will raise an error on code that attempts to modify it. For example:
-<sourcepawn>void CantChangeArray(const array[], int index, int value)
+<sourcepawn>void CantChangeArray(const int[] array, int index, int value)
+{
     array[index] = value;    //Won't compile