efun: set_connection_charset


SYNOPSIS:

        void set_connection_charset (int* bitvector, int quote_iac)
        void set_connection_charset (string charset, int quote_iac)
        void set_connection_charset (0, int quote_iac)

DESCRIPTION:

        Set the set of characters that can be output to the
        interactive user (this does not apply to binary_message() ).
        The function must be called by the interactive user object
        itself.

        The charset can be given either directly as a string, or
        indirectly as a bitvector. If the charset is given as the
        number 0, the default connection charset is re-established.

        The bitvector is interpreted as an array of 8-bit-values and
        might contain up to 32 elements. Character n is allowed to be
        output if sizeof(bitvector) > n/8 && bitvector[n/8] & (1 << n%8) .

        If quote_iac is 0 and char 255 is allowed to be output, IAC
        will be output unmodified.
        If quote_iac is 1 and char 255 is allowed to be output, char
        255 will be quoted so that it is not interpreted as IAC by the
        telnet protocol. This is the default.

HISTORY:

        Introduced in 3.2.1@40.
        LDMud 3.2.8 added the ability to specify the charset as a string.
        LDMud 3.2.10 added the ability to reset the charset to the default.

SEE ALSO:

	
	get_connection_charset(E), binary_message(E), set_combine_charset(E)

UNItopia (mudadm@UNItopia.de)