On text - Revision history

NaNg: Added references to "why doesn't my text event work"

2012-03-23T07:23:14Z

Added references to "why doesn't my text event work"

← Older revision		Revision as of 07:23, 23 March 2012
Line 15:		Line 15:
	'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].		'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].

	'''Note''' that mIRC iterates the triggers in the script files one by one, and when a trigger is catched, other triggers ''in the same script file'' will not be triggered. A "catch-all" trigger (a trigger which catches all events, marked with matchtext of *) should be placed last of the "on TEXT" triggers in the script file.		'''Note''' that mIRC iterates the triggers in the script files one by one, and when a trigger is catched, other triggers ''in the same script file'' will not be triggered. A "catch-all" trigger (a trigger which catches all events, marked with matchtext of *) should be placed last of the "on TEXT" triggers in the script file. See also [[Why doesnt my text event work]].

	== Examples ==		== Examples ==
Line 48:		Line 48:
	* [[On_input\|On Input]] to trigger to your own text.		* [[On_input\|On Input]] to trigger to your own text.
	* [[Wildcards]] for information on using * and ? in matchtext		* [[Wildcards]] for information on using * and ? in matchtext
			* [[Why doesnt my text event work]]

	[[Category:Events]]		[[Category:Events]]

NaNg: Trigger iterations and catch-all

2011-08-08T19:53:46Z

Trigger iterations and catch-all

← Older revision		Revision as of 19:53, 8 August 2011
Line 14:		Line 14:

	'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].		'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].

			'''Note''' that mIRC iterates the triggers in the script files one by one, and when a trigger is catched, other triggers ''in the same script file'' will not be triggered. A "catch-all" trigger (a trigger which catches all events, marked with matchtext of *) should be placed last of the "on TEXT" triggers in the script file.

	== Examples ==		== Examples ==

Aca20031: Links to Wildcards

2009-07-31T16:41:16Z

Links to Wildcards

← Older revision		Revision as of 16:41, 31 July 2009
Line 1:		Line 1:
	The on TEXT event triggers when you receive private and/or channel messages.		The on TEXT event triggers when you receive private and/or channel messages.
	on <level>:TEXT:<matchtext>:<*><?><#[,#]>:<commands>		on <level>:TEXT:<[[wildcards\|matchtext]]>:<*><?><#[,#]>:<commands>

	The matchtext can be a [[If-Then-Else#The_Operators\|wildcard]] match or even a [[Regular_Expression\|regular expression]].		The matchtext can be a [[If-Then-Else#The_Operators\|wildcard]] match or even a [[Regular_Expression\|regular expression]].
Line 6:		Line 6:

	Read [[Access_Levels\|access levels]] to get more info about the <level> field.		Read [[Access_Levels\|access levels]] to get more info about the <level> field.

			Read [[wildcards]] to get more information about how to use matchtext to match unknown words, words that may change.

	The location where this event occurrs can be either any channel (#), a certain channel (#channel), a query (?) or all (*).		The location where this event occurrs can be either any channel (#), a certain channel (#channel), a query (?) or all (*).
Line 33:		Line 35:

	You can also combine identifiers and variables inside the $(...) identifier.		You can also combine identifiers and variables inside the $(...) identifier.
	On :Text:$($+(,$me,*)):?: { echo -a $nick mentioned your nick in a query. }		On :Text:[[$(...)\|$]]([[DollarPlus\|$+]](,$me,*)):?: { echo -a $nick mentioned your nick in a query. }
	This triggers when someone says any line containing your nick in a query. The matchtext is basically $me, but in order to get that $me evaluated to your current nick, you need to use the $(...) identifier.		This triggers when someone says any line containing your nick in a query. The matchtext is basically $me, but in order to get that $me evaluated to your current nick, you need to use the $(...) identifier.

Line 43:		Line 45:
	* [[if\|if-statements]] to make more restrictions.		* [[if\|if-statements]] to make more restrictions.
	* [[On_input\|On Input]] to trigger to your own text.		* [[On_input\|On Input]] to trigger to your own text.
			* [[Wildcards]] for information on using * and ? in matchtext

	[[Category:Events]]		[[Category:Events]]

Cail at 09:00, 2 July 2007

2007-07-02T09:00:12Z

← Older revision		Revision as of 09:00, 2 July 2007
Line 41:		Line 41:

	== See Also ==		== See Also ==
	~~To make more restrictions, you can use~~ [[if\|if-statements]].		* [[if\|if-statements]] to make more restrictions.
			* [[On_input\|On Input]] to trigger to your own text.
	~~To trigger your own text, you need to use the~~ [[On_input\|On Input]] ~~event~~.

	[[Category:Events]]		[[Category:Events]]

Albie: removed useless .* in regex

2006-07-13T11:47:32Z

removed useless .* in regex

← Older revision		Revision as of 11:47, 13 July 2006
Line 37:		Line 37:


	On $:Text:/.\s200\d\s.*/:#: { echo -a $nick just mentioned some year in channel $chan $+ ! }		On $*:Text:/\s200\d\s/:#: { echo -a $nick just mentioned some year in channel $chan $+ ! }
	This is a regular expression match. It triggers when someone mentions a year between 2000-2009 in any channel. mIRC syntax requires the //'s around the expression.		This is a regular expression match. It triggers when someone mentions a year between 2000-2009 in any channel. mIRC syntax requires the //'s around the expression.

Microbe: added examples

2006-02-18T15:51:40Z

added examples

← Older revision		Revision as of 15:51, 18 February 2006
Line 7:		Line 7:
	Read [[Access_Levels\|access levels]] to get more info about the <level> field.		Read [[Access_Levels\|access levels]] to get more info about the <level> field.

	The location where this event occurrs can be either a channel (#), a query (?) or ~~both~~ (*).		The location where this event occurrs can be either any channel (#), a certain channel (#channel), a query (?) or all (*).

	You can also use variables as matchtext and location parameter. See below for ~~an example~~.		You can also use variables and identifiers as matchtext and location parameter. See below for examples.

	'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].		'''Note''' that you can't test out these events by typing text to yourself. To test them, use another connection, that you can establish via [[Server\|/server]].

	== ~~Example~~ ==		== Examples ==

	On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[DollarPlus\|$+]] . }		On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[DollarPlus\|$+]] . }
	This will echo "<nick> just said moo in <channel>", when someone has said a sentence with "moo" in it.		This will echo "<nick> just said moo in <channel>.", when someone has said a sentence with "moo" in it.


Line 25:		Line 25:
	On *:Text:%mymatchtext:%mychannels: { [[beep]] }		On *:Text:%mymatchtext:%mychannels: { [[beep]] }
	The value of %mymatchtext will be matched against whatever text the user sends, and the value of %mychannels will be matched against the channel to which the message was sent. If both matched, it will beep.		The value of %mymatchtext will be matched against whatever text the user sends, and the value of %mychannels will be matched against the channel to which the message was sent. If both matched, it will beep.


			To get identifiers evaluated in the matchtext, you need to use a special identifier [[$(...)]]. If you use this identifier in the matchtext, you can't have anything else outside this identifier in the matchtext.
			On *:Text:$([[$me]]):#: { beep }
			This beeps when someone says your nick (but nothing else than your nick) in any channel.


			You can also combine identifiers and variables inside the $(...) identifier.
			On :Text:$($+(,$me,*)):?: { echo -a $nick mentioned your nick in a query. }
			This triggers when someone says any line containing your nick in a query. The matchtext is basically $me, but in order to get that $me evaluated to your current nick, you need to use the $(...) identifier.


			On $:Text:/.\s200\d\s.*/:#: { echo -a $nick just mentioned some year in channel $chan $+ ! }
			This is a regular expression match. It triggers when someone mentions a year between 2000-2009 in any channel. mIRC syntax requires the //'s around the expression.

	== See Also ==		== See Also ==
	To make more restrictions, you ~~have to~~ use [[if\|if-statements]].		To make more restrictions, you can use [[if\|if-statements]].

	To trigger your own text, you need to use the [[On_input\|On Input]] event.		To trigger your own text, you need to use the [[On_input\|On Input]] event.

	[[Category:Events]]		[[Category:Events]]

Albie: added space to make it more legible which example goes with which text.

2005-12-15T16:25:20Z

added space to make it more legible which example goes with which text.

← Older revision		Revision as of 16:25, 15 December 2005
Line 17:		Line 17:
	On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[DollarPlus\|$+]] . }		On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[DollarPlus\|$+]] . }
	This will echo "<nick> just said moo in <channel>", when someone has said a sentence with "moo" in it.		This will echo "<nick> just said moo in <channel>", when someone has said a sentence with "moo" in it.


	On :Text::?: { echo -a $nick just said in query: $1- }		On :Text::?: { echo -a $nick just said in query: $1- }
	This will echo everything someone said to you in query in your active window, as $1- refers to the entire text that was said to you.		This will echo everything someone said to you in query in your active window, as $1- refers to the entire text that was said to you.


	On *:Text:%mymatchtext:%mychannels: { [[beep]] }		On *:Text:%mymatchtext:%mychannels: { [[beep]] }
	The value of %mymatchtext will be matched against whatever text the user sends, and the value of %mychannels will be matched against the channel to which the message was sent. If both matched, it will beep.		The value of %mymatchtext will be matched against whatever text the user sends, and the value of %mychannels will be matched against the channel to which the message was sent. If both matched, it will beep.

Doomie at 15:07, 15 December 2005

2005-12-15T15:07:54Z

← Older revision		Revision as of 15:07, 15 December 2005
Line 25:		Line 25:
	To make more restrictions, you have to use [[if\|if-statements]].		To make more restrictions, you have to use [[if\|if-statements]].

	To trigger your own text, you need to use the [[~~On_Input~~\|On Input]] event.		To trigger your own text, you need to use the [[On_input\|On Input]] event.

	[[Category:Events]]		[[Category:Events]]

Albie: changed iswm link

2005-11-30T13:10:57Z

changed iswm link

← Older revision		Revision as of 13:10, 30 November 2005
Line 2:		Line 2:
	on <level>:TEXT:<matchtext>:<*><?><#[,#]>:<commands>		on <level>:TEXT:<matchtext>:<*><?><#[,#]>:<commands>

	The matchtext can be a [[~~iswm~~\|wildcard]] match or even a [[Regular_Expression\|regular expression]].		The matchtext can be a [[If-Then-Else#The_Operators\|wildcard]] match or even a [[Regular_Expression\|regular expression]].
	To use regular expressions as matchtext, you need the [[Access_Levels\|$-Prefix]].		To use regular expressions as matchtext, you need the [[Access_Levels\|$-Prefix]].

Doomie at 14:56, 5 October 2005

2005-10-05T14:56:00Z

← Older revision		Revision as of 14:56, 5 October 2005
Line 15:		Line 15:
	== Example ==		== Example ==

	On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[$+]] . }		On :Text:moo*:#: { [[echo]] -a [[$nick]] just said moo in [[$chan]] [[DollarPlus\|$+]] . }
	This will echo "<nick> just said moo in <channel>", when someone has said a sentence with "moo" in it.		This will echo "<nick> just said moo in <channel>", when someone has said a sentence with "moo" in it.
	On :Text::?: { echo -a $nick just said in query: $1- }		On :Text::?: { echo -a $nick just said in query: $1- }