summaryrefslogtreecommitdiff
path: root/toxcore/tox.h
diff options
context:
space:
mode:
authorirungentoo <irungentoo@gmail.com>2013-10-11 06:42:07 -0700
committerirungentoo <irungentoo@gmail.com>2013-10-11 06:42:07 -0700
commit31f5d7a8abacd045de1d55a0462d17d14095073c (patch)
tree31e93f067cf7f89b00d650f8f8fd7ba0fd640efb /toxcore/tox.h
parent77ec51085828c8dbe764030cbae7242994e590de (diff)
parent571412f911326a988d0d84019ea6a4ee8b49b17d (diff)
Merge pull request #618 from nurupo/action-messages-with-id
Added message ids to action messages
Diffstat (limited to 'toxcore/tox.h')
-rw-r--r--toxcore/tox.h12
1 files changed, 9 insertions, 3 deletions
diff --git a/toxcore/tox.h b/toxcore/tox.h
index db4e6b57..39832073 100644
--- a/toxcore/tox.h
+++ b/toxcore/tox.h
@@ -209,7 +209,7 @@ int tox_friend_exists(Tox *tox, int friendnumber);
209 * return the message id if packet was successfully put into the send queue. 209 * return the message id if packet was successfully put into the send queue.
210 * return 0 if it was not. 210 * return 0 if it was not.
211 * 211 *
212 * You will want to retain the return value, it will be passed to your read receipt callback 212 * You will want to retain the return value, it will be passed to your read_receipt callback
213 * if one is received. 213 * if one is received.
214 * m_sendmessage_withid will send a message with the id of your choosing, 214 * m_sendmessage_withid will send a message with the id of your choosing,
215 * however we can generate an id for you by calling plain m_sendmessage. 215 * however we can generate an id for you by calling plain m_sendmessage.
@@ -219,10 +219,16 @@ uint32_t tox_sendmessage_withid(Tox *tox, int friendnumber, uint32_t theid, uint
219 219
220/* Send an action to an online friend. 220/* Send an action to an online friend.
221 * 221 *
222 * return 1 if packet was successfully put into the send queue. 222 * return the message id if packet was successfully put into the send queue.
223 * return 0 if it was not. 223 * return 0 if it was not.
224 *
225 * You will want to retain the return value, it will be passed to your read_receipt callback
226 * if one is received.
227 * m_sendaction_withid will send an action message with the id of your choosing,
228 * however we can generate an id for you by calling plain m_sendaction.
224 */ 229 */
225int tox_sendaction(Tox *tox, int friendnumber, uint8_t *action, uint32_t length); 230uint32_t tox_sendaction(Tox *tox, int friendnumber, uint8_t *action, uint32_t length);
231uint32_t tox_sendaction_withid(Tox *tox, int friendnumber, uint32_t theid, uint8_t *action, uint32_t length);
226 232
227/* Set friendnumber's nickname. 233/* Set friendnumber's nickname.
228 * name must be a string of maximum MAX_NAME_LENGTH length. 234 * name must be a string of maximum MAX_NAME_LENGTH length.