CallRemoteFunction

From SA-MP Wiki

Jump to: navigation, search


Description:

Calls a public function in any script that is loaded.


Image:32px-Circle-style-warning.png

Important
Note

CallRemoteFunction crashes the server if it's passing an empty string.


Parameters:
(const function[], const format[], {Float,_}:...)
function[]Public function's name.
format[]Tag/format of each variable
{Float,_}:...'Indefinite' number of arguments of any tag


Return Values:

The value that the last public function returned.


Format Strings

Placeholder Meaning
a Passes an array (the next placeholder should be d or i for the array size, so the function will be aware of it).

NOTE: It accepts only one dimension, so a trick like sizeof (array) + sizeof (array) * sizeof (array[]) for the array size would be needed to pass a 2D array.

c Passes a single character.
d, i Passes an integer (whole) number
x Passes a number in hexadecimal notation.
f Passes a floating point number.
s Passes a string.

The values for the placeholders follow in the exact same order as parameters in the call.

Example Usage:

forward CallMe(number, const string[]);
public CallMe(number, const string[])
{
    printf("CallMe called. Int: %i  String: %s.", number, string);
    return 1;
}
 
// Somewhere... in another file perhaps?
CallRemoteFunction("CallMe", "is", 69, "this is a string");

Related Functions

The following functions may be useful, as they are related to this function in one way or another.

Personal tools
In other languages