CallRemoteFunction

From SA-MP Wiki

Jump to: navigation, search

Description:

Calls a public function in any script that is loaded.

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");