Link message - Revision history

Nelson Jenkins: Add note comparing to llGetLinkNumber, expand comment and code in first snippet, fix formatting for parameters in text

2023-01-06T00:59:47Z

Add note comparing to llGetLinkNumber, expand comment and code in first snippet, fix formatting for parameters in text

← Older revision		Revision as of 17:59, 5 January 2023
Line 5:		Line 5:
	\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.		\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.
	\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.		\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.
	\|event_footnote=~~'''~~id~~'''~~ is often used as a second string field (in LSL the [[key]] type is implemented as a [[string]] with just custom operators). [[typecast\|Typecasting]] between [[string]] and [[key]] types has no effect on the data contained. The sizes of ~~'''~~str~~'''~~ and ~~'''~~id~~'''~~ are only limited by available script memory.		\|event_footnote={{LSLP\|id}} is often used as a second string field (in LSL the [[key]] type is implemented as a [[string]] with just custom operators). [[typecast\|Typecasting]] between [[string]] and [[key]] types has no effect on the data contained. The sizes of {{LSLP\|str}} and {{LSLP\|id}} are only limited by available script memory.
	\|constants		\|constants
	\|spec		\|spec
	\|caveats=*64 link_message events can queue, past that, they are silently dropped! Don't do too much in the event if they might be coming in fast.		\|caveats=*64 link_message events can queue, past that, they are silently dropped! Don't do too much in the event if they might be coming in fast.
	~~'''~~sender_num~~'''~~ does not reflect how a message was sent, there is no way to know if it was sent with a LINK_ flag or the [[llGetLinkNumber\|specific link number]].		{{LSLP\|sender_num}} does not reflect how a message was sent, there is no way to know if it was sent with a LINK_ flag or the [[llGetLinkNumber\|specific link number]].
	*If ~~'''~~str~~'''~~ and ~~'''~~id~~'''~~ are bigger than available memory the script will crash with a Stack-Heap Collision.		*If {{LSLP\|str}} and {{LSLP\|id}} are bigger than available memory the script will crash with a Stack-Heap Collision.
	\|examples=		\|examples=
	<source lang="lsl2">		<source lang="lsl2">
	//This is just an example script, you shouldn't handle touches within single script this way.		// This is just an example script, you shouldn't handle touches within a single script this way.

	default		default
Line 29:		Line 29:
	</source>		</source>
	\|helpers=		\|helpers=
			=== Sending Lists ===
	<source lang="lsl2">		<source lang="lsl2">
	// This is just an example script, you shouldn't handle link ~~message~~ within single script this way.		// This is just an example script, you shouldn't handle link messages within a single script this way.

	default		default
	{		{
	// To propagate an unlimited number of arguments of any type.		// To propagate an unlimited number of arguments of any type, as long as you don't run out of memory.
	// ~~Presumed~~, the separator string ~~isn't~~ used in any source string!		// For low-latency operations, it is more efficient to concatenate the parameters into a string manually all at once, which avoids the comparatively slower llDumpList2String call but is not as flexible.
			// The separator string cannot be used in any source string, or the resulting list will be incorrectly parsed.
			// It is possible to design your own custom escape sequence for any instances of the separator string or use a rarer character, though that is outside the scope of this snippet.

	state_entry()		state_entry()
	{		{
	list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];		list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];
	string list_parameter = llDumpList2String(my_list, "\|"); // Produce a \| delimited string from the list		string list_parameter = llDumpList2String(my_list, "\|"); // Produce a \| delimited string from the list
	llMessageLinked(LINK_THIS, 0, list_parameter, NULL_KEY);		llMessageLinked(LINK_THIS, 0, list_parameter, NULL_KEY);
Line 46:		Line 49:
	link_message(integer sender_num, integer num, string list_argument, key id)		link_message(integer sender_num, integer num, string list_argument, key id)
	{		{
	list re_list = ~~llParseString2List~~(list_argument, ["\|"], [""]); // Convert the string back to a list		if (list_argument != "")
	}		{
			list re_list = llParseStringKeepNulls(list_argument, ["\|"], [""]); // Convert the string back to a list
			// llParseStringKeepNulls is used here in lieu of llParseString2List to accommodate any elements of my_list that were empty strings, which would otherwise be deleted.
			// Note that re_list will be a list of strings no matter what my_list contained, so only llList2String can be used on it, not llList2Integer, llList2Vector, etc.
			}
			else
			{
			// my_list was an empty list (or a list that contained only one empty string), so llParseStringKeepNulls is not necessary because it would potentially incorrectly return a list with a single blank string.
			// It is not possible to distinguish between the two, so it would be wise to check which is the case before sending if possible.
			}
			}
	}		}
	</source>		</source>
Line 56:		Line 69:
	\|also_footer		\|also_footer
	\|notes={{LSL Tip\|A script can hear its own link messages.}}		\|notes={{LSL Tip\|A script can hear its own link messages.}}
			* {{LSLP\|sender_num}} can be compared to [[llGetLinkNumber]] to determine whether the message was sent by the same prim, regardless of whether the prim is unlinked, a root, or a child.
	\|mode		\|mode
	\|cat1=Link		\|cat1=Link

BrownBoxStudio Resident: Added description for 3rd parameter

2016-01-20T04:02:18Z

Added description for 3rd parameter

← Older revision		Revision as of 21:02, 19 January 2016
Line 2:		Line 2:
	\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=~~Third parameter of~~ the llMessageLinked ~~call~~.		\|p3_type=string\|p3_name=str\|p3_desc= The message that was sent from the script that called [[llMessageLinked]].
	\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.		\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.
	\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.		\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.

Lady Sumoku: Replaced old block with

2015-01-22T08:24:15Z

Replaced old <LSL> block with <source lang="lsl2">

← Older revision		Revision as of 01:24, 22 January 2015
Line 12:		Line 12:
	*If '''str''' and '''id''' are bigger than available memory the script will crash with a Stack-Heap Collision.		*If '''str''' and '''id''' are bigger than available memory the script will crash with a Stack-Heap Collision.
	\|examples=		\|examples=
	<~~lsl~~>		<source lang="lsl2">
	//This is just an example script, you shouldn't handle touches within single script this way.		//This is just an example script, you shouldn't handle touches within single script this way.

Line 27:		Line 27:
	}		}
	}		}
	</~~lsl~~>		</source>
	\|helpers=		\|helpers=
	<~~lsl~~>		<source lang="lsl2">
	// This is just an example script, you shouldn't handle link message within single script this way.		// This is just an example script, you shouldn't handle link message within single script this way.

Line 49:		Line 49:
	}		}
	}		}
	</~~lsl~~>		</source>
	\|also_header		\|also_header
	\|also_events		\|also_events

Strife Onizuka: typo

2013-12-25T08:29:15Z

typo

← Older revision		Revision as of 01:29, 25 December 2013
Line 1:		Line 1:
	{{LSL_Event\|event_id=29\|event_delay\|event=link_message		{{LSL_Event\|event_id=29\|event_delay\|event=link_message
	\|p1_type=integer\|~~pp1_subtype~~=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.		\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.

Strife Onizuka at 08:29, 25 December 2013

2013-12-25T08:29:00Z

← Older revision		Revision as of 01:29, 25 December 2013
Line 1:		Line 1:
	{{LSL_Event\|event_id=29\|event_delay\|event=link_message		{{LSL_Event\|event_id=29\|event_delay\|event=link_message
	\|p1_type=integer\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|pp1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.		\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.

Omei Qunhua: Corrected uncompilable example (missing ;) ... Calling an ll function is not 'typecasting'

2012-12-27T16:27:33Z

Corrected uncompilable example (missing ;) ... Calling an ll function is not 'typecasting'

← Older revision		Revision as of 09:27, 27 December 2012
Line 24:		Line 24:
	link_message(integer source, integer num, string str, key id)		link_message(integer source, integer num, string str, key id)
	{		{
	~~// PUBLIC_CHANNEL has the integer value 0~~		llWhisper(0, str + " (" + (string)id + ") touched me!");
	llWhisper(~~PUBLIC_CHANNEL~~, str + " (" + (string)id + ") touched me!");
	}		}
	}		}
Line 41:		Line 40:
	{		{
	list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];		list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];
	string list_parameter = llDumpList2String(my_list, "\|"); // ~~Typecast list to~~ a string		string list_parameter = llDumpList2String(my_list, "\|"); // Produce a \| delimited string from the list
	llMessageLinked(LINK_THIS, 0, list_parameter, NULL_KEY)		llMessageLinked(LINK_THIS, 0, list_parameter, NULL_KEY);
	}		}

	link_message(integer sender_num, integer num, string list_argument, key id)		link_message(integer sender_num, integer num, string list_argument, key id)
	{		{
	list re_list = llParseString2List(list_argument, ["\|"], [""]); // ~~Typecast~~ string back to a list		list re_list = llParseString2List(list_argument, ["\|"], [""]); // Convert the string back to a list
	}		}
	}		}

Kireji Haiku at 21:54, 28 October 2012

2012-10-28T21:54:53Z

← Older revision		Revision as of 14:54, 28 October 2012
Line 56:		Line 56:
	\|also_articles		\|also_articles
	\|also_footer		\|also_footer
	\|notes=A script can hear its own link messages.		\|notes={{LSL Tip\|A script can hear its own link messages.}}
	\|mode		\|mode
	\|cat1=Link		\|cat1=Link

Kireji Haiku: some minor readability improvements in the code

2012-10-06T22:57:44Z

some minor readability improvements in the code

← Older revision		Revision as of 15:57, 6 October 2012
Line 17:		Line 17:
	default		default
	{		{
	touch_start(integer c)		touch_start(integer num_detected)
	{		{
	llMessageLinked(LINK_THIS, 0, llDetectedName(0), llDetectedKey(0));		llMessageLinked(LINK_THIS, 0, llDetectedName(0), llDetectedKey(0));
	}		}

	link_message(integer source, integer num, string str, key id)		link_message(integer source, integer num, string str, key id)
	{		{
	llWhisper(0, str + " (" + (string)id + ") touched me!");		// PUBLIC_CHANNEL has the integer value 0
			llWhisper(PUBLIC_CHANNEL, str + " (" + (string)id + ") touched me!");
	}		}
	}		}
Line 32:		Line 34:

	default		default
	{ // To propagate an unlimited number of arguments of any type.		{
	// Presumed, the separator string isn't used in any source string!		// To propagate an unlimited number of arguments of any type.
			// Presumed, the separator string isn't used in any source string!

	state_entry()		state_entry()
	{		{

Blues Stilman: The two code examples had conflicting styles. I adjusted the oddball to the style used on most of the other LSL pages.

2010-02-10T17:02:04Z

The two code examples had conflicting styles. I adjusted the oddball to the style used on most of the other LSL pages.

← Older revision		Revision as of 10:02, 10 February 2010
Line 31:		Line 31:
	// This is just an example script, you shouldn't handle link message within single script this way.		// This is just an example script, you shouldn't handle link message within single script this way.

	default{ // To propagate an unlimited number of arguments of any type.		default
			{ // To propagate an unlimited number of arguments of any type.
	// Presumed, the separator string isn't used in any source string!		// Presumed, the separator string isn't used in any source string!
	state_entry() {		state_entry()
			{
	list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];		list my_list = [1, 2.0, "a string", <1, 2, 3>, <1, 2, 3, 4>, llGetOwner()];
	string list_parameter = llDumpList2String(my_list, "\|"); // Typecast list to a string		string list_parameter = llDumpList2String(my_list, "\|"); // Typecast list to a string
Line 39:		Line 41:
	}		}

	link_message(integer sender_num, integer num, string list_argument, key id) {		link_message(integer sender_num, integer num, string list_argument, key id)
			{
	list re_list = llParseString2List(list_argument, ["\|"], [""]); // Typecast string back to a list		list re_list = llParseString2List(list_argument, ["\|"], [""]); // Typecast string back to a list
	}		}

Giuliani Rossini at 02:31, 16 August 2009

2009-08-16T02:31:34Z

← Older revision		Revision as of 19:31, 15 August 2009
Line 10:		Line 10:
	\|caveats=*64 link_message events can queue, past that, they are silently dropped! Don't do too much in the event if they might be coming in fast.		\|caveats=*64 link_message events can queue, past that, they are silently dropped! Don't do too much in the event if they might be coming in fast.
	'''sender_num''' does not reflect how a message was sent, there is no way to know if it was sent with a LINK_ flag or the [[llGetLinkNumber\|specific link number]].		'''sender_num''' does not reflect how a message was sent, there is no way to know if it was sent with a LINK_ flag or the [[llGetLinkNumber\|specific link number]].
	*If '''str''' and '''id''' are bigger ~~then~~ available memory the script will crash with a Stack-Heap Collision.		*If '''str''' and '''id''' are bigger than available memory the script will crash with a Stack-Heap Collision.
	\|examples=		\|examples=
	<lsl>		<lsl>

← Older revision		Revision as of 21:02, 19 January 2016
Line 2:		Line 2:
	\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=~~Third parameter of~~ the llMessageLinked ~~call~~.		\|p3_type=string\|p3_name=str\|p3_desc= The message that was sent from the script that called [[llMessageLinked]].
	\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.		\|p4_type=key\|p4_name=id\|p4_desc=Fourth parameter of the llMessageLinked call.
	\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.		\|event_desc=Triggered when the script receives a link message that was sent by a call to [[llMessageLinked]]. llMessageLinked is used to send messages from one script to another.

← Older revision		Revision as of 01:29, 25 December 2013
Line 1:		Line 1:
	{{LSL_Event\|event_id=29\|event_delay\|event=link_message		{{LSL_Event\|event_id=29\|event_delay\|event=link_message
	\|p1_type=integer\|~~pp1_subtype~~=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|p1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.		\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.

← Older revision		Revision as of 01:29, 25 December 2013
Line 1:		Line 1:
	{{LSL_Event\|event_id=29\|event_delay\|event=link_message		{{LSL_Event\|event_id=29\|event_delay\|event=link_message
	\|p1_type=integer\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].		\|p1_type=integer\|pp1_subtype=link\|p1_name=sender_num\|p1_desc=The link number of the prim that contained the script that called [[llMessageLinked]].
	\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.		\|p2_type=integer\|p2_name=num\|p2_desc=Second parameter of the llMessageLinked call.
	\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.		\|p3_type=string\|p3_name=str\|p3_desc=Third parameter of the llMessageLinked call.