Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > delete |  |

delete

Syntax

    system.movie.delete ["movieName"]
    system.movie.delete ["movieName1", "movieName2", "movieName3"]
    system.group.delete ["groupName"]
    system.group.delete ["groupName1", "groupName2", "groupName3"]
    system.user.delete ["userID"]
    system.user.delete ["userID1", "userID2", "userID3"]

Description

Multiuser Server command; when `movie` is specified, immediately deletes all instances of the given movie or movies from the server. New connections to that movie are still possible if the `disable` command has not been called.

If `group` is specified, the given group(s) is deleted from the server. This does not delete the users who occupied the group.

If `user` is specified, the given user(s) is immediately disconnected from the server. To disconnect several users, send a list of users.

The server responds with a message that has the same object and command in the `#sender` parameter and the same `#subject` and `#contents`.

Note: There is also a `delete` command in the general Lingo Dictionary that is applied to chunk expressions. It should not be confused with the Multiuser Server `delete` command, which is always used in the context of a `sendNetMessage()` command.

Examples

This statement deletes all instances of the movie TankWars on the server:

    errCode = gMultiuserInstance.sendNetMessage("system.movie.delete", "anySubject" "TankWars")

To delete more than one movie, use a list containing the movie names:

    errCode = gMultiuserInstance.sendNetMessage("system.movie.delete", "anySubject" ["TankWars", "TicTacToe", "Checkers"])

This statement deletes the group @RedTeam from the server:

    errCode = gMultiuserInstance.sendNetMessage("system.group.delete", "anySubject" "@RedTeam")

This statement disconnects the user BillyJoe from the server:

    errCode = gMultiuserInstance.sendNetMessage("system.user.delete", "anySubject", "BillyJoe")

See also

`sendNetMessage()`, `disable`