View source for Scripting Book/Chapter 11

== Introduction ==

Today we're going to learn how to get a shortened name of somebody and then remove their head.

=== What we're going to use ===

We're going to use ''string.match''.

== A function ==

We're going to make a function to do so.
The function can be called ''match_name''.

<pre>
function match_name(name)
</pre>

As you can see it contains one argument labeled 'name' this argument will contain the shortened name of the player who we want to decapitate.

== Matching ==

We're going to use string.match to start with.

This uses two arguments, the first argument is the full name and the second argument is the shortened name.

{{Example|
<nowiki>print( string.match( "Hello", "He" ) )</nowiki><br/><br/>
<nowiki>> He</nowiki> 
}}

=== Step 1 ===

First we will get the names of every player who is currently playing the game.

<pre>
for _,v in pairs(game.Players:GetChildren()) do
</pre>

=== Step 2 ===

Now we're going to use string.match with the first argument as 'v.Name' which is the player's name in a variable called 'player'.

<pre>
player = string.match(v.Name, 
</pre>

=== Step 3 ===

For the second argument we must put the shortened version, which the function's argument, which is 'name'.

<pre>
player = string.match(v.Name, name)
</pre>

== Checking ==

Now we must check that this name actually belongs to the player.

<pre>
function match_name(name)
   for _,v in pairs(game.Players:GetChildren()) do
      player = string.match(v.Name, name)
      if player then
</pre>

Next we need to get the player's character and remove their head and end any opened statements or functions.

<pre>
function match_name(name)
   for _,v in pairs(game.Players:GetChildren()) do
      player = string.match(v.Name, name)
      if player then
         player.Character.Head:Remove()
      end
   end
end
</pre>

== Calling the function ==

All we need to do to call the function is ''match_name("Soul")''.

<pre>match_name("Soul")</pre>


[[Scripting_Book/Chapter_10|Go to previous chapter]] or [[Scripting_Book/Chapter_12|Continue to Chapter 12]]

[[Category:Scripting_Book_Chapters]]