GetVehicleNameFromID: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
m (Visual improvement)
 
(7 intermediate revisions by 4 users not shown)
Line 1: Line 1:
__NOTOC__  
{{Server client function}}
Allows you to input a vehicleID and return a vehicle name from that ID
__NOTOC__
{{Deprecated|getVehicleNameFromModel}}
 
Gets the name of a vehicle by its model id.


==Syntax==  
==Syntax==  
Line 11: Line 14:


===Returns===
===Returns===
Returns ''true'' if vehicle exists, ''false'' otherwise.
Returns the name of the vehicle if the id was valid, ''false'' otherwise.


==Example==  
==Example==  
This example does...
This will retrieve the name of a car so its name can be displayed when the player chooses to spawn a car by ID.
 
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
addCommandHandler ( "spawncar", "createcarcommand" )
function createvehiclecommand ( sourcePlayer, commandName, carid )
function createcarcommand ( player, commandName, carid )
-- This function is triggered by the text "spawnvehicle" in the console.
--This function is triggered by the text "spawncar" in the console.
-- The player must specify the parameter 'carid' to specify
--The player must also specify the added varible carid to specify
-- what car they wish to spawn.
--what car they wish to spawn.
local x, y, z = getElementPosition ( sourcePlayer )
local x, y, z = getElementPosition ( player )
-- Get the position of the player to spawn the car near this location
--Get the position of the player to spawn the car near this location
local carname = getVehicleNameFromID ( tonumber(carid) )
createVehicle ( carid, x + 5, y, z )
-- Get the name of the car the player asked for and store it in the
--Spawn the car at x + 5 from the player so it doesn't crush him
-- variable 'carname'
carname = getVehicleNameFromID ( carid )
if carname == false then
--Get the name of the car the player asked for and store it to the
outputChatBox ( "That is not a valid car ID", sourcePlayer )
--varible 'carname'
if carname == "" then
outputChatBox ( "That is not a valid car ID" )
else
else
outputChatBox ( "A "..carname.." was created!" )
createVehicle ( carid, x + 5, y, z )
-- Spawn the car at x + 5 from the player so it doesn't crush him
outputChatBox ( "A " .. carname .. " was created!" )
end
end
--A string is always returned in this situation, so if the car doesn't
-- If the entered car ID is invalid, false will be returned.
--exist the string has no values. If the string does have any value, we
-- Otherwise a string is returned, we create the car and announce the car name in the chatbox.
--announce it in the chatbox because it is a vehicle.
end
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )
</syntaxhighlight>
</syntaxhighlight>


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

Latest revision as of 11:31, 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 getVehicleNameFromModel instead.


Gets the name of a vehicle by its model id.

Syntax

string getVehicleNameFromID ( int id )

Required Arguments

  • id: This is a vehicle id. See vehicle to see what values will return names (true).

Returns

Returns the name of the vehicle if the id was valid, false otherwise.

Example

This will retrieve the name of a car so its name can be displayed when the player chooses to spawn a car by ID. 

function createvehiclecommand ( sourcePlayer, commandName, carid )
	-- This function is triggered by the text "spawnvehicle" in the console.
	-- The player must specify the parameter 'carid' to specify
	-- what car they wish to spawn.
	local x, y, z = getElementPosition ( sourcePlayer )
	-- Get the position of the player to spawn the car near this location
	local carname = getVehicleNameFromID ( tonumber(carid) )
	-- Get the name of the car the player asked for and store it in the
	-- variable 'carname'
	if carname == false then
		outputChatBox ( "That is not a valid car ID", sourcePlayer )
	else
		createVehicle ( carid, x + 5, y, z )
		-- Spawn the car at x + 5 from the player so it doesn't crush him
		outputChatBox ( "A " .. carname .. " was created!" )
	end
	-- If the entered car ID is invalid, false will be returned.
	-- Otherwise a string is returned, we create the car and announce the car name in the chatbox.
end
addCommandHandler ( "spawnvehicle", createvehiclecommand )

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetVehicleNameFromID?oldid=40326"