SendPlayerMessageToPlayer

From SA-MP Wiki

Jump to: navigation, search


Description:

Sends a message in the name of a player to another player on the server. The message will appear in the chat box but can only be seen by the user specified with 'playerid'. The line will start with the sender's name in their color, followed by the message in white.


Parameters:
(playerid, senderid, const message[])
playeridThe ID of the player who will receive the message.
senderidThe sender's ID. If invalid, the message will not be sent.
const message[]The message that will be sent.


Return Values:

  • 1: The function executed successfully.
  • 0: The function failed to execute. This means the player specified does not exist.


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

Important
Note

Avoid using format specifiers in your messages without formatting the string that is sent. It will result in crashes otherwise.


Example Usage:

public OnPlayerCommandText(playerid, cmdtext[])
{
    if(!strcmp(cmdtext, "/hello", true))
    {
        SendPlayerMessageToPlayer(0, playerid, "Hello ID 0!"); //Will send a message to the user with the ID 0 in the name of the user who typed '/hello'.
        // Assuming 'playerid' is called Tenpenny, the output will be 'Tenpenny: Hello ID 0!'
        return 1;
    }
    return 0;
}

Related Functions

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


Related Callbacks

The following callbacks might be useful, as they're related to this function in one way or another.

  • OnPlayerText: Called when a player sends a message via the chat.
Personal tools
In other languages