[E2] gvar overhaul

[Divran]

What's New
I've remade gvars from scratch. They are now much more optimized. I kept most of the old function names for compatibility.
The old syntax works just like usual, except the fact that gSetGroup now persists (it didn't before). However, it is recommended to use the new syntax for several reasons:
1) The old syntax still only supports the same data types as it did before (strings, numbers, vectors, angles and entities), while the new syntax supports EVERY SINGLE type.
2) The new syntax's syntax is a lot neater and easier to use.
I was not able to find any bugs, but please report any bugs as soon as possible so that they can be fixed.



Tutorial
I'll now take some time to go through exactly how the new syntax works.

Functions
A list of all functions now available:

Function		Returns		Description
- New syntax -
gTable(S)		GT		Returns a non-shared gtable with the group 'S'
gTable(S,N) 		GT		Returns a gtable with the group 'S'. 'N' determines wether or not it is shared.
GT:remove*(S)		*		Removes and returns the variable of the type '*' at the index 'S'
gRemoveAll*()		-		Removes all variables of the type '*' in your non-shared table.
gRemoveAll() 		- 		Resets the entire non-shared table (ie ALL your variables in every group)

- Old syntax -
gSetGroup(S)		-		Sets the E2's current group. Does persist.
gGetGroup()		S		Gets the E2's current group.
gShare(N)		-		Sets wether or not you want to share the variables. (1/0)
gGetShare()		N		Returns 1/0
gSet*(S,*)		-		Sets a variable of the type '*' at index 'S' in the current group.
gGet*(S)		*		Gets a variable of the type '*' from index 'S' in the current group.
gSet*(N,*)		-		Exactly the same as "gSet*(N:toString(),*)"
gGet*(N)		-		Exactly the same as "gGet*(N:toString())"
gDelete*(S)		*		Removes and returns the variable of the type '*' at the index 'S' in the current group.
gDelete*(N)		*		Exactly the same as gDelete*(N:toString())
gDeleteAll*()		-		Exactly the same as gRemoveAll*() (Remember that this function is only for compatibility)

Usage
Here are two example E2s which show how to use the new syntax.

#Expression nr 1
@inputs Button1 Button2
@persist G:gtable
if (first()) {G = gTable("mygroup",0)} #Get the gtable from a group, and make it non-shared (non-shared means only YOUR E2s can read & write on this table.)
if (Button1) {G["button",number] = 1} #If the first button is pressed, set the number to 1.
if (Button2) {G["button",number] = 2} #If the second button is pressed, set the number to 2.

#Expression nr 2
@inputs Check
@persist G:gtable
if (first()) {G = gTable("mygroup",0)} #Get the same gtable as the first E2
if (Check) { #When you press the check button...
    print("The last pressed button is:", G["button",number],"!") #Tell me which button was pressed on the first E2
}

That should clear things up!

[Filipe]

Already tried them out, it's an enormous improvement over the old system, awesome work, Divran!

[feha]

Now someone should compare which overhaul is less laggy XD (prolly divrans).

[adadr]

wow this makes gvars so much easier

[jacoby6000]

Could you make a function to add all of the variables from a table into a gvar, so you can send it a chunk of data all at once, or from a load file.. Ex:

gTable("myGroup"):append(Table)

It would add all of the indexes from table "Table" and overwrite the already used ones.

[Buggzie]

good job, i'm liking this, Its better than the old gGetNum gGetString etc

[Divran]

Could you make a function to add all of the variables from a table into a gvar, so you can send it a chunk of data all at once, or from a load file.. Ex:

gTable("myGroup"):append(Table)

It would add all of the indexes from table "Table" and overwrite the already used ones.

You can simply save the table to a gvar:

@persist G:gtable
if (first()) {G = gTable("mygroup",0)}
G["mytable",table] = Table

Edit: Later today I will fix up the Wiki and write a more thorough list of the changes. For now, enjoy the first bugfix!

[E2] dataSignal - Made datasignals unable to send gtables.
[E2] gvars - Made gtables unable to save gtables to themselves.
[E2] gvars - Added new function "gTable(S)", which works the same as "gTable(S,0)".
[E2] gvars - Changed the name of the function called "gRemove*" to "remove*" and and "gRemoveNormal" to "removeNumber".

[Divran]

Updated first post with a small tutorial

EDIT: Updated wiki. Is this good? http://wiki.garrysmod.com/?title=Wir...obal_Variables

[jacoby6000]

[QUOTE=Divran;196791]You can simply save the table to a gvar:

@persist G:gtable
if (first()) {G = gTable("mygroup",0)}
G["mytable",table] = Table

What if you just wanted the values from the table there, and not the table itself? I know that you could easily extract them from the table, but one less step, right?

[Syranide]

[QUOTE=jacoby6000;197062]

You can simply save the table to a gvar:

@persist G:gtable
if (first()) {G = gTable("mygroup",0)}
G["mytable",table] = Table

What if you just wanted the values from the table there, and not the table itself? I know that you could easily extract them from the table, but one less step, right?

Value = gTable("mygroup",0)["mytable",table]