| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 1 | SYNOPSIS |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 2 | object snoop(object snooper) |
| 3 | object snoop(object snooper, object snoopee) |
| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 4 | |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 5 | DESCRIPTION |
| 6 | Starts a snoop from 'snooper' on 'snoopee', or if 'snoopee' is not |
| 7 | given, terminates any snoop from 'snooper'. |
| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 8 | |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 9 | Return <snoopee> on success, or 0 for a failure (including snooping |
| 10 | loops). |
| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 11 | |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 12 | The snoop is checked with the master object for validity. It |
| 13 | will also fail if a snoop would result in a recursive snoop |
| 14 | action. |
| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 15 | |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 16 | <snooper> can be an interactive player, or an object. If it is |
| 17 | an interactive player, the snooped text is prepended with a |
| 18 | '%' and send directly to the players connection. If <snooper> |
| 19 | is an object, the snooped text is sent in two calls to the |
| 20 | object's catch_tell() lfun: the first call passes just the |
| 21 | "%" (plus the prompt if the object changed it), the second the |
| 22 | actual text. |
| MG Mud User | 88f1247 | 2016-06-24 23:31:02 +0200 | [diff] [blame] | 23 | |
| Zesstra | 715ec20 | 2025-07-09 22:18:31 +0200 | [diff] [blame^] | 24 | SEE ALSO |
| 25 | query_snoop(E), catch_tell(A) |