-
Notifications
You must be signed in to change notification settings - Fork 72
What's new
See Known compiler bugs for the full list of known bugs and their current status.
Toggles compatibility mode on or off.
Note: this pragma will not change the value of __Pawn.
Suppress the "must return a value" warning for a function.
This can be used on functions that don't have a return statement but still return
a value, e.g. via #emit retn.
This directive comes in two forms:
#pragma warning (enable|disable) XXX
Enable or disable a warning by its number.
Useful for hiding unwanted warnings that otherwise cannot be fixed.
#pragma warning (push|pop)
Save or restore the list of currently disabled warnings.
This can be used in conjuction with the previous form to toggle warnings for a piece of code:
#pragma warning push
#pragma warning disable XXX
// some code here
...
#pragma warning popPrint a user warning.
This works similar to the #error directive. For example, compiling a file
that contains
#warning Don't include this filewould result in
warning 237: user warning: Don't include this file
The built-in __line constant is set to the current line number.
Backported from Pawn 4.0.
__file is always set to the name of the current source code file.
Current date. Example: 05 Feb 2017.
Current time in 24-hour format. Example: 13:05:24.
This is the time when the compiler started executing. It doesn't change during compilation, no matter how long it takes.
Set to 0 (zero) if compatibility mode is disabled and any non-zero value otherwise.
Compiler build number. For example: if compiler version is 3.10.123 is the 123 part.
If you have an enum where one of the members (fields) is an array:
enum Foo {
a,
b[10]
};
new bar[100][Foo];and you use it in a function that has a parameter with a default value equal to sizeof(other_parameter), for instance:
f(x[], size = sizeof(x)) {
#pragma unused x
printf("size = %d", size); // size = 10
}
main() {
f(bar[0][b]);
}the size parameter would be set to the size of b, i.e. 10 cells, as opposed to 1 cell like with the old compiler.
Some might argue that sizeof should return 1 in such cases, since enums are not real structures but just numbers, and x[0][b] refers to a single cell, but that is rather counter-intuitive and may lead to hard to find mistakes, such as in this code:
strcat(x[b], "some string");Backported from Pawn 3.3.4058.
Initialization of two-dimensional arrays can be continued with an ellipsis operator, similar to one-dimensional arrays. For example, the following code:
new a[5][10] = {{0, 1, 2, ...}, {0, 2, 4, ...}, ...};is equivalent to:
new a[5][10] = {
{0, 1, 2, 3, 4, 5, 6, 7, 8, 9},
{0, 2, 4, 6, 8, 10, 12, 14, 16, 18},
{0, 3, 6, 9, 12, 15, 18, 21, 24, 27},
{0, 4, 8, 12, 16, 20, 24, 28, 32, 36},
{0, 5, 10, 15, 20, 25, 30, 35, 40, 45}
};It is possible to define arrays with 4 dimensions:
new a[2][3][4][5] = { /* ... */ };The following changes may break existing code (use -Z to disable them):
The automatic generation of _inc_XXX symbols was disabled due to their inconsistent behavior across platforms (Linux vs. Windows). See #6 for details.
In order to make it possible to include the same file multiple times without getting compile errors you can add something like this to your include file:
#if defined YOUR_INCLUDE_INC
#endinput
#endif
#define YOUR_INCLUDE_INC
// code goes hereThe value of the built-in __Pawn constant was changed from 0x0302 to 0x030A (#5). This allows you to do detect this compiler at compile time:
#if __Pawn == 0x030A
// some code here
#else
// alternative code
#endif