Globals - Revision history

Marc Gurevitx at 10:21, 23 May 2023

2023-05-23T10:21:55Z

JoeStrout: Reverted edits by Thacuber2a03 (talk) to last revision by JoeStrout

2022-09-09T21:59:10Z

Reverted edits by Thacuber2a03 (talk) to last revision by JoeStrout

Thacuber2a03: it's a map, "globals isa map" returns 1

2022-09-09T20:03:58Z

it's a map, "globals isa map" returns 1

JoeStrout at 21:50, 16 June 2022

2022-06-16T21:50:15Z

JoeStrout: /* Example */

2022-06-16T21:49:19Z

Example

JoeStrout: added "See also"

2020-06-03T15:24:37Z

added "See also"

JoeStrout: added category tags

2020-06-03T15:24:00Z

added category tags

JoeStrout: Created page with "'''globals''' is a built-in keyword that references variables at the global scope. Any assignment outside of any function creates (or updates) an entry in the '''globals'..."

2020-06-03T13:44:23Z

Created page with "'''globals''' is a built-in keyword that references variables at the global scope. Any assignment outside of any function creates (or updates) an entry in the '''globals'..."

New page

'''globals''' is a built-in keyword that references [[variables]] at the global scope. Any assignment outside of any function creates (or updates) an entry in the '''globals''' map.

Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable. Local variables exist only within the function where they are created, and disappear as soon as the function exits. This is true even if there happens to already be a global variable of the same name.

So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used.

== Example ==
The ''check'' function below compares its parameter to a global variable. The comparison does not need the '''globals''' keyword, because it's only reading the value (and there is no local variable of the same name). But when it updates the global value, it has to use '''globals'''.

<ms>lastValue = null
check = function(someValue)
if someValue != lastValue then
print "The value is now: " + someValue
globals.lastValue = someValue // <--- Note use of globals
end if
end function

x = 0
while true
check round(x)
x = x + 0.1
wait 0.1
end while</ms>

Also note that the [[while]] loop at the end is at the global scope, so it does not need to use '''globals'' at all; globals and locals are the same in this case.

← Older revision		Revision as of 10:21, 23 May 2023
Line 1:		Line 1:
−	'''globals''' is a built-in keyword that references [[variables]] at the global scope. ~~Any~~ assignment outside of any function creates (or updates) an entry in the '''globals''' map.	+	'''globals''' is a built-in keyword that references [[variables]] at the global scope. In the main program, any assignment outside of any function creates (or updates) an entry in the '''globals''' map.

	Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable. Local variables exist only within the function where they are created, and disappear as soon as the function exits. This is true even if there happens to already be a global variable of the same name.		Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable. Local variables exist only within the function where they are created, and disappear as soon as the function exits. This is true even if there happens to already be a global variable of the same name.

@@ Line 1: / Line 1: @@
-'''globals''' is a built-in map that references [[variables]] at the global scope.  Any assignment outside of any function creates (or updates) an entry in the '''globals''' map.
+'''globals''' is a built-in keyword that references [[variables]] at the global scope.  Any assignment outside of any function creates (or updates) an entry in the '''globals''' map.
 Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable.  Local variables exist only within the function where they are created, and disappear as soon as the function exits.  This is true even if there happens to already be a global variable of the same name.
-So, when you want to create or update a global variable inside a function, the '''globals''' map must be used on the left-hand side of the assignment.
+So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used on the left-hand side of the assignment.
 See also: [[locals]]; [[outer]].
 == Example ==
-The ''check'' function below compares its parameter to a global variable.  The comparison does not need the '''globals''' map, because it's only reading the value (and there is no local variable of the same name).  But when it updates the global value, it has to use '''globals'''.
+The ''check'' function below compares its parameter to a global variable.  The comparison does not need the '''globals''' keyword, because it's only reading the value (and there is no local variable of the same name).  But when it updates the global value, it has to use '''globals'''.
 <ms>lastValue = null

@@ Line 1: / Line 1: @@
-'''globals''' is a built-in keyword that references [[variables]] at the global scope.  Any assignment outside of any function creates (or updates) an entry in the '''globals''' map.
+'''globals''' is a built-in map that references [[variables]] at the global scope.  Any assignment outside of any function creates (or updates) an entry in the '''globals''' map.
 Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable.  Local variables exist only within the function where they are created, and disappear as soon as the function exits.  This is true even if there happens to already be a global variable of the same name.
-So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used on the left-hand side of the assignment.
+So, when you want to create or update a global variable inside a function, the '''globals''' map must be used on the left-hand side of the assignment.
 See also: [[locals]]; [[outer]].
 == Example ==
-The ''check'' function below compares its parameter to a global variable.  The comparison does not need the '''globals''' keyword, because it's only reading the value (and there is no local variable of the same name).  But when it updates the global value, it has to use '''globals'''.
+The ''check'' function below compares its parameter to a global variable.  The comparison does not need the '''globals''' map, because it's only reading the value (and there is no local variable of the same name).  But when it updates the global value, it has to use '''globals'''.
 <ms>lastValue = null

@@ Line 3: / Line 3: @@
 Inside a function, an unqualified assignment (i.e. an assignment to an identifier that does not follow a dot — like ''x'' rather than ''foo.x'') creates a local variable.  Local variables exist only within the function where they are created, and disappear as soon as the function exits.  This is true even if there happens to already be a global variable of the same name.
-So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used.
+So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used on the left-hand side of the assignment.
 See also: [[locals]]; [[outer]].

@@ Line 25: / Line 25: @@
 end while</ms>
-Also note that the [[while]] loop at the end is at the global scope, so it does not need to use '''globals'' at all; globals and locals are the same in this case.
+Also note that the [[while]] loop at the end is at the global scope, so it does not need to use '''globals''' at all; globals and locals are the same in this case.
 [[Category:Language]]
 [[Category:Intrinsic Functions]]

← Older revision		Revision as of 15:24, 3 June 2020
Line 4:		Line 4:

	So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used.		So, when you want to create or update a global variable inside a function, the '''globals''' keyword must be used.
		+
		+	See also: [[locals]]; [[outer]].

	== Example ==		== Example ==

← Older revision		Revision as of 15:24, 3 June 2020
Line 24:		Line 24:

	Also note that the [[while]] loop at the end is at the global scope, so it does not need to use '''globals'' at all; globals and locals are the same in this case.		Also note that the [[while]] loop at the end is at the global scope, so it does not need to use '''globals'' at all; globals and locals are the same in this case.
		+
		+	[[Category:Language]]
		+	[[Category:Intrinsic Functions]]