send_message

NAME

send_message - send a message to a user

SYNOPSIS

int send_message(string message)

int send_message(int code)

DESCRIPTION

In the first form, send a message to the user associated with the current object. Used by the driver object, send_message() will write the message on stderr. In the second form, send_message(0) means turn input echoing on, and send_message(1) means turn input echoing off; they are only meaningful for telnet connections. Use of send_message(-1) is described below.

The function will return 0 if there is room for more messages, and 1 if not. If it returns 1, the driver will call message_done() in this object when all messages have been sent; if this object calls send_message() again before message_done() has been called, the remainder of the previous message will be discarded.

Calling send_message(-1) will return 0 if all messages have been sent, and 1 if not. If it returns 1, the driver will call message_done() in this object when all messages have been sent.

Destructing a connection object before all messages have been sent may cause the messages to be lost.

ERRORS

Calling send_message() in an object that is not connected will result in an error.

SEE ALSO

query_ip_number, this_user, connect, open_port, users

HTMLised 1998 Greg Lewis (glewis@maths.adelaide.edu.au)