Engine:CCMD alias - Revision history

Bear: /* Details */

2023-10-15T00:20:22Z

Details

← Older revision		Revision as of 00:20, 15 October 2023
Line 15:		Line 15:
	Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.		Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.

	Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can use the special key state associations.		Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can use the special key state associations. By default, only aliases in the 'global' context will be found by key bindings using 'bind'.

	== Examples ==		== Examples ==

Bear: /* Details */

2023-10-15T00:01:45Z

Details

← Older revision		Revision as of 00:01, 15 October 2023
Line 15:		Line 15:
	Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.		Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.

	Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can ~~have direct key bindings and~~ use special key state associations.		Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can use the special key state associations.

	== Examples ==		== Examples ==

Bear: /* Details */

2023-10-15T00:01:13Z

Details

← Older revision		Revision as of 00:01, 15 October 2023
Line 15:		Line 15:
	Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.		Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.

	Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings.		Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings and use special key state associations.

	== Examples ==		== Examples ==

Bear at 23:54, 14 October 2023

2023-10-14T23:54:38Z

← Older revision		Revision as of 23:54, 14 October 2023
Line 1:		Line 1:
	{{dev/uiccmd}}		{{dev/uiccmd}}
	Creates a new alias ~~wiht~~ a callable script in the current context, replacing existing alias if any.		Creates a new alias with a callable script in the current context, replacing existing alias if any.
	<kua>alias bob "echo fred"</kua>		<kua>alias bob "echo fred"</kua>

Bear: /* Arguments */

2023-10-14T23:53:22Z

Arguments

← Older revision		Revision as of 23:53, 14 October 2023
Line 5:		Line 5:
	== Arguments ==		== Arguments ==
	* name - name for the new alias		* name - name for the new alias
	* value (optional) - script string or command to set as an alias. If not supplied, then prints the alias script value if alias exists.		* value (optional) - script string or command to set as an alias. If not supplied, then prints the alias script value if the alias exists.

	== Associations ==		== Associations ==

Bear: /* Arguments */

2023-10-14T23:52:07Z

Arguments

← Older revision		Revision as of 23:52, 14 October 2023
Line 5:		Line 5:
	== Arguments ==		== Arguments ==
	* name - name for the new alias		* name - name for the new alias
	* value - script string or command to set as an alias		* value (optional) - script string or command to set as an alias. If not supplied, then prints the alias script value if alias exists.

	== Associations ==		== Associations ==

Bear: /* Default values */

2023-10-14T23:50:38Z

Default values

← Older revision		Revision as of 23:50, 14 October 2023
Line 19:		Line 19:
	== Examples ==		== Examples ==
	=== Default values ===		=== Default values ===
	* ~~Checks~~ alias 'bob' for script value. No alias exists named 'bob'.		* Check alias 'bob' for script value. No alias exists named 'bob'.
	<kua>		<kua>
	> alias bob		> alias bob
	Unknown: bob		Unknown: bob
	</kua>		</kua>
	* 'bob' ~~called without a value~~. No command, variable or alias named 'bob' exist.		* Call 'bob'. No command, variable or alias named 'bob' exist.
	<kua>		<kua>
	> bob		> bob

Bear: /* Default values */

2023-10-14T23:49:21Z

Default values

← Older revision		Revision as of 23:49, 14 October 2023
Line 19:		Line 19:
	== Examples ==		== Examples ==
	=== Default values ===		=== Default values ===
			* Checks alias 'bob' for script value. No alias exists named 'bob'.
			<kua>
			> alias bob
			Unknown: bob
			</kua>
	* 'bob' called without a value. No command, variable or alias named 'bob' exist.		* 'bob' called without a value. No command, variable or alias named 'bob' exist.
	<kua>		<kua>
Line 24:		Line 29:
	Unknown: bob		Unknown: bob
	</kua>		</kua>
	* ~~Creates~~ an alias 'bob' and ~~sets~~ to 'echo fred'.		* Create an alias 'bob' and set to 'echo fred'.
	<kua>		<kua>
	> alias bob "echo fred"		> alias bob "echo fred"
	</kua>		</kua>
	* Same as the ~~first~~ example, but now alias 'bob' exists. The 'echo' command in the 'bob' alias script runs, and prints 'fred'.		* Same as the second example, but now alias 'bob' exists. The 'echo' command in the 'bob' alias script runs, and prints 'fred'.
	<kua>		<kua>
	> bob		> bob
	fred		fred
			</kua>
			* Same as the first example, but now alias 'bob' exists and shows the value of the alias 'bob'
			<kua>
			> alias bob
			'bob' is 'echo fred'
	</kua>		</kua>

Bear: /* Details */

2023-10-14T21:26:14Z

Details

← Older revision		Revision as of 21:26, 14 October 2023
Line 13:		Line 13:
	An 'alias' acts like a custom command. It runs the assigned text as a script, which can contain a single-word command, statement, or script. Is used to create a custom command in the current context.		An 'alias' acts like a custom command. It runs the assigned text as a script, which can contain a single-word command, statement, or script. Is used to create a custom command in the current context.

	Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text"~~, where~~ the second parameter was ignored.		Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text". Here the second parameter was ignored.

	Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings.		Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings.

Bear: /* Details */

2023-10-14T21:25:48Z

Details

← Older revision		Revision as of 21:25, 14 October 2023
Line 13:		Line 13:
	An 'alias' acts like a custom command. It runs the assigned text as a script, which can contain a single-word command, statement, or script. Is used to create a custom command in the current context.		An 'alias' acts like a custom command. It runs the assigned text as a script, which can contain a single-word command, statement, or script. Is used to create a custom command in the current context.

	Aliases do not ~~take~~ any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text", where the second parameter was ignored.		Aliases do not have any parameters and will run the command, statement, or script verbatim. If for example, an alias named 'bob' is set to 'echo', it will always run exactly 'echo' which will print nothing, even if you run 'bob "some text", where the second parameter was ignored.

	Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings.		Thus, aliases act like simple static macros. But when run they can do anything a script in the same context run by any other means could do. And because aliases are treated like commands, they can have direct key bindings.