Arrays - Revision history

CoDEmanX at 18:38, 28 July 2009

2009-07-28T18:38:02Z

← Older revision		Revision as of 18:38, 28 July 2009
Line 1:		Line 1:
	~~== [[~~Arrays~~]] ==~~		{{Note\|Arrays are objects that store several variables. These can be integers, strings, entities or even other arrays.}}

	~~[[Image:Nutshell.png]]~~ Arrays ~~are objects that store several variables. These can be integers, strings, entities or even other arrays.~~		== Arrays ==

	Arrays are extremely helpful when it comes to doing the same thing to several different objects, such as moving a few platforms by a certain amount in a map, or storing lots of related variables.		Arrays are extremely helpful when it comes to doing the same thing to several different objects, such as moving a few platforms by a certain amount in a map, or storing lots of related variables.

CoDEmanX at 18:33, 28 July 2009

2009-07-28T18:33:17Z

← Older revision		Revision as of 18:33, 28 July 2009
Line 43:		Line 43:

	Arrays are a complicated part of scripting, but once you have them understood, they are one of the most useful things in the game.		Arrays are a complicated part of scripting, but once you have them understood, they are one of the most useful things in the game.

			[[Category:Call of Duty]]
			[[Category:Scripting]]

Novemberdobby at 23:39, 23 October 2008

2008-10-23T23:39:41Z

New page

== [[Arrays]] ==

[[Image:Nutshell.png]] Arrays are objects that store several variables. These can be integers, strings, entities or even other arrays.

Arrays are extremely helpful when it comes to doing the same thing to several different objects, such as moving a few platforms by a certain amount in a map, or storing lots of related variables.

To create an array we simply type...
<pre>
arrayName = [];
</pre>
Now, to add an object/variable to this array, we can simply use:
<pre>
array(array.size) = "a string variable";
</pre>
Whenever you see array.size, the .size does not mean it's dimensions, but the amount of items in the array. So if an array contains 1 piece of data, the array.size is 1. To retrieve an items from an array, you can use array[0] for the first object/var stored in it, and then array[1] and so on for successive items.

Going back to the example above, we could retrieve the data by using array[0]. The first item in an array is listed as 0, the second as 1, and so on. This means that by using array(array.size) = "blah";, we can add new items to it because of the offset of 1.

A common use for an array is to call a function on all of the players in the game. This can be done by using an array with a FOR loop.
To start with we must get our array of players, and instead of using the above method of defining an array and adding custom data, we can use a builtin function.

players = getEntArray("player", "classname");

So, our array has been defined as "players", or more accurately, "players[]".

Inside "players[]" is every player on the server, and now all we need to do is use the array to thread a function to each player.
So, here we have a for loop to do such a thing:
<pre>
for(i = 0; i < players.size; i++)
{
players[i] thread function();
}
</pre>
That's our loop to go through every player and call function(); on them.

Remember, 'i' is a variable not a letter, so 'i' is substitued with the number of the loop.
In the first loop, 'i' equals 0, so:

players[0] thread function();

is executed.

Arrays are a complicated part of scripting, but once you have them understood, they are one of the most useful things in the game.

Zeroy: New page: == Arrays == Image:Nutshell.png Arrays are "multivariables". You can store several pieces of data within a single array. This can be integers, strings or pieces of data such as ta...

2008-10-15T16:53:49Z

New page: == Arrays == Image:Nutshell.png Arrays are "multivariables". You can store several pieces of data within a single array. This can be integers, strings or pieces of data such as ta...

New page

== [[Arrays]] ==

[[Image:Nutshell.png]] Arrays are "multivariables". You can store several pieces of data within a single array. This can be integers, strings or pieces of data such as targetnames and etc.

Arrays are the answwer to having to use multiple variables or in mapping, you can use a single targetname.

Arrays are the key to more efficient scripts and maps. If your map contains lots of entities which do the exact same thing (such as moving platforms) then you should be using an array to manipulate them.

To create an array we simply type...

arrayName = [];

Now we have an array, we need to add to this array, this would be a pretty advanced process if the IW developers had not built a function for us. The function can be accessed using...

maps\mp\_utility::add_to_array(array, ent);[/code]

So, for example, we have an array called "arrayName" and what we want to add is a string in a variable named "arrayString", put that into the above code...

maps\mp\_utility::add_to_array(arrayName, arrayString);

Now, a couple of things to remember about arrays is their size.
Whenever you see, <ent>.size the .size does not mean dimension, but "how many". So if an array contains 1 piece of data, the array.size is 1.
Another thing is calling the array. A piece of data is called from an array using the array number...

So, if we go back to the example, we have just put arrayString inside arrayName, so our arrayName.size = 1. To get that information back we use

arrayName[0]

This is where it gets a little confusing. Your array size is always 1 bigger than you array, this is because your array starts at 0.
If you had 10 pieces of data in the array, the size would be ten but you would only be able to call [0]-[9].

A common use for the array is to thread a function to all of the players on the server. This can be done using an array with a for loop.
So, first off we must get our array, and instead of using the above method of defining an array and adding custom data, we use a builtin command.

players = getEntArray("player", "classname");

So, our array has been defined as "players" or more accurately "players[]"
Inside "players[]" is every player on the server, and now all we need to do is use the array to thread a function to each player.
So, here we have a for loop to do such a thing.

for(i=0;i<players.size;i++)

Thats our loop, 'i=0' (do not change this number, it is important). While 'i' is LESS than 'players.size' (remember, the size is always 1 bigger than the final number in the array), 'i++'.

{
players[i] thread function();
}

And that above simply threads the function to each person in the array. Remember, 'i' is a variable not a letter, so 'i' is substitued with the number of the loop.
The first loop, 'i' equals 0, so

players[0] thread function();

The second loop, 'i' equals 1 and etc.
If the amount of players on the server is 10 then loop will loop while 'i' is less than the size of the array (10). This means the 'i' will equal 0,1,2...,9.

Arrays are a complicated part of scripting, but once you have them understood, they are one of the most useful things.