GetVehicleIDFromName: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
 
m (Visual improvement)
 
(13 intermediate revisions by 10 users not shown)
Line 1: Line 1:
[[Category:Incomplete]]
__NOTOC__
{{server client function}}
{{Deprecated|getVehicleModelFromName}}


__NOTOC__
This function retrieves the ID of a vehicle as an integer value from its name.
This fake function is for use with blah & blah and does blahblahblabhalbhl


==Syntax==  
==Syntax==  
Line 10: Line 11:


===Required Arguments===  
===Required Arguments===  
*'''argumentName:''' description
*'''name:''' A [[string]] containing the name of the vehicle.
 
===Optional Arguments===
{{OptionalArg}}
*'''argumentName2:''' descriptiona
*'''argumentName3:''' description


===Returns===
===Returns===
Returns ''true'' if blah, ''false'' otherwise.
Returns an [[int]] if the name exists, ''false'' otherwise.
If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID.


==Example==  
==Example==  
This example does...
This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
--This line does...
function createvehiclecommand ( sourcePlayer, commandName, carname )
blabhalbalhb --abababa
-- This function is triggered by the text "spawnvehicle" in the console.
--This line does this...
-- The player must specify the added parameter 'carname' to specify
mooo
-- what car they wish to spawn.
local carid = getVehicleIDFromName ( carname )
-- Get the ID of the car the player asked for and store it to the
-- variable 'carid'
local x, y, z = getElementPosition ( sourcePlayer )
-- Get the position of the player to spawn the car near this location
if carid == false then
outputChatBox ( "That is not a valid car name" )
else
createVehicle ( carid, x + 5, y, z )
-- Spawn the car using its ID. Spawn it at x + 5 from the player so it doesn't crush him
outputChatBox ( "A vehicle with an ID of " .. carid .. " was created!" )
end
-- If the entered car name returns no car ID, the string will be empty and false will be returned.
-- If the string does have any value, we create the car and announce the car ID in the chatbox,
-- because a car did exist under the given car name.
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )
</syntaxhighlight>
</syntaxhighlight>


==See Also==
==See Also==
{{FunctionArea_Functions}}
{{Vehicle functions}}

Latest revision as of 11:29, 26 June 2014

Emblem-important.png This function is deprecated. This means that its use is discouraged and that it might not exist in future versions.
Please use getVehicleModelFromName instead.


This function retrieves the ID of a vehicle as an integer value from its name.

Syntax

int getVehicleIDFromName ( string name )

Required Arguments

  • name: A string containing the name of the vehicle.

Returns

Returns an int if the name exists, false otherwise. If you use this function on vehicles with shared names, such as "police", it will return the earliest occurrence of that vehicle's ID.

Example

This will allow the player to create a vehicle by name and it's ID will be displayed in the chatbox when the vehicle is spawned. 

function createvehiclecommand ( sourcePlayer, commandName, carname )
	-- This function is triggered by the text "spawnvehicle" in the console.
	-- The player must specify the added parameter 'carname' to specify
	-- what car they wish to spawn.
	local carid = getVehicleIDFromName ( carname )
	-- Get the ID of the car the player asked for and store it to the
	-- variable 'carid'
	local x, y, z = getElementPosition ( sourcePlayer )
	-- Get the position of the player to spawn the car near this location
	if carid == false then
		outputChatBox ( "That is not a valid car name" )
	else
		createVehicle ( carid, x + 5, y, z )
		-- Spawn the car using its ID. Spawn it at x + 5 from the player so it doesn't crush him
		outputChatBox ( "A vehicle with an ID of " .. carid .. " was created!" )
	end
	-- If the entered car name returns no car ID, the string will be empty and false will be returned.
	-- If the string does have any value, we create the car and announce the car ID in the chatbox,
	-- because a car did exist under the given car name.
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetVehicleIDFromName?oldid=40325"