Using return In a Function
return will stop a function and take the script back to the line where the function was originally called. If there is something after the keyword
return, that information is sent back through the function.
In this case,
return brings back the value of
currentIndex and stores it in the original variable where
findValue() was called.
Removing the Found Value
If a value was found using the find function, then it can be removed. Check if a value was found with an if statement.
- Check if a value is inside
valueFound, and if so, remove the value using
- Print out the array using the code below.
- Playtest and check that the first
"Bread"value was removed from the array. Try removing other values by changing the second parameter in
Before removing the first "Bread"
"Bread"was removed. The next section will cover how to find and remove all instances.
Finding Other Value Types in an Array »
While the function
findValue() works with string and number values, be careful with the specific values you compare. For example, if you had a player, you’d need to check their
Name value using the comparison:
player.Name == "playerNameToCheck"
Find and Remove All of a Value
While the previous code could only remove the first instance of a value found, this code snippet will find and remove all occurrences of from an array.
Remember, removing items causes later indexes to shift. Instead of starting at the beginning of the array, start at the end to avoid accidentally skipping values. By starting at the last index, you won’t change the indexes of the values before it.
- Use an array named
playerItemswith at least four values and a set of duplicates.
- To go through the array, create a for loop that goes backwards through
playerItems, starting at #playerItems, ending at
1, and incrementing by
- In the loop, use an if statement to check if the value inside
playerItems[index]is equal to
"Bread", if so remove the item.
- Use the code below to add a second
for loopthat prints the array.
- Run the script and check that all valued named
Finished Project Sample
The following project includes all scripts in this tutorial. Download here.
Note, all scripts are in ServerScriptService and disabled. To use a script, in its properties, uncheck the Disabled field and run Studio.