View source for LlRegionSayTo

{{LSL_Function
|inject-2={{Issues/SCR-66}}
{{LSL_Function/chat|channel|msg|nd=*|direct=*}}
{{LSL_Function/uuid|target|sim=*}}
|func_id=363
|func_sleep=0.0
|func_energy=10.0
|func=llRegionSayTo
|sort=RegionSayTo
|p1_type=key|p1_name=target
|p2_type=integer|p2_name=channel
|p3_type=string|p3_name=msg
|func_desc=Says the text supplied in string {{LSLP|msg}} on channel supplied in integer {{LSLP|channel}} to the object or avatar specified by {{LSLP|target}}
|return_text
|spec
|caveats=
*Text is spoken directly to the object or avatar within the same region as the script.
*Scripts in tasks other than {{LSLP|target}} can not listen and receive these text messages, with an exception for attachments described below.
*Text can be a maximum of 1023 bytes.
*A prim cannot hear itself, to prevent problems with recursion.
*Sending text on {{#var:DEBUG_CHANNEL}} is not supported
*Text sent to an avatar's ID on channel zero will be sent to the viewer.
*Text sent to an avatar's ID on non-zero channels can be heard by any attachment on the avatar
|examples=
<lsl>
default
{
    touch_start(integer num_detected)
    {
        key id = llDetectedKey(0);

        // send a message to the chat window of the touching avatar
        // PUBLIC_CHANNEL has the integer value 0
        llRegionSayTo(id, PUBLIC_CHANNEL, "You touched this!");

        // send a message to the attachments of the avatar touching
        // example channel: -12345
        llRegionSayTo(id, -12345, "Hello there attachments!");
    }
}
</lsl>

|helpers
|also_events=
{{!}}-
{{!}}{{!}}{{!}} style="width:9em;" {{!}}
{{LSL DefineRow||[[listen]]|Receives chat}}
|also_functions=
{{!}}-
{{!}}{{!}}{{!}} style="width:9em;" {{!}}
{{LSL DefineRow||[[llListen]]|Ask for listen events}}
{{LSL DefineRow||[[llInstantMessage]]|Sends chat to a specific avatar, inside our outside the current region.}}
{{LSL DefineRow||[[llOwnerSay]]|Sends chat to the owner only to avoid spamming the PUBLIC_CHANNEL}}
{{LSL DefineRow||[[llRegionSay]]|Sends chat region wide}}
{{LSL DefineRow||[[llSay]]|Sends chat limited to 20 meters}}
{{LSL DefineRow||[[llShout]]|Sends chat limited to 100 meters}}
{{LSL DefineRow||[[llWhisper]]|Sends chat limited to 10 meters}}
|also_tests
|also_articles={{LSL DefineRow||[[Hello Avatar]]}}
|notes=
* Channel {{HoverText|0|Zero}} is the {{#var:PUBLIC_CHANNEL}}. This should only be used for chat intended to be sent to the viewer.
* If one object 'says' something to another object (''e.g''., a button that, when touched, turns on a lamp), it is a good idea to use a very negative channel, ''e.g.'',
<lsl>
    llRegionSayTo("55499a64-45c3-4b81-8880-8ffb5a7c251b",-5243212,"turn on");
</lsl>
Negative channels are popular for script communications because the standard Second Life client is unable to chat directly on those channels ("/-xxxx message" won't chat "message" on channel "-xxxx", it will chat "/-xxxx message" on channel zero). The only way to do so prior to [[llTextBox]] was to use [[llDialog]], which is limited to 24 characters, or certain third-party viewers.
|cat1
|cat2
|cat3
|cat4
}}