Examples
substitute can translate messages output by one object to what's expected by another object
Substitute a symbol for another symbol in a message
| Name | Type | Opt | Description |
|---|---|---|---|
| match | anything | opt | The first number or symbol specifies the match, which identifies what should be replaced in an incoming message. The default match value is 0. |
| replacement | anything | opt | The second number or symbol specifies the replacement for the match. The default replacement value is 0. |
| replace-message-only-mode | anything | opt | Any third number or symbol sets the "replace message only" mode of the substitute object. Only the first instance of the specified match will be replaced. |
| bang | Same as . | |
| int | input [int] |
Same as . |
| float | input [float] |
Same as . |
| list | match or match-replacement-pair [list] |
Same as . |
| anything | input [list] |
In left inlet: The input is echoed to the output, but if the message received contains an element matching the match symbol or number, the element is replaced by the replacement symbol or number when the message is repeated to the output. In right inlet: The substitute object accepts a message of two numbers or symbols in its right inlet. The first number or symbol specifies the match, which identifies what should be replaced in an incoming message. |
| set | match or match-replacement-pair [list] |
In left inlet: Same as . In right inlet: Same as , except that the word set is ignored. |