IsTrainDerailed: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
mNo edit summary
 
(7 intermediate revisions by 5 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__
[[Category:Needs_Example]]
{{Server client function}}
{{Server client function}}
This function will check if a train or tram is derailed.
This function will check if a train or tram is derailed.
Line 8: Line 7:
bool isTrainDerailed ( vehicle vehicleToCheck )               
bool isTrainDerailed ( vehicle vehicleToCheck )               
</syntaxhighlight>  
</syntaxhighlight>  
 
{{OOP||[[vehicle]]:isDerailed|derailed|setTrainDerailed}}
===Required Arguments===  
===Required Arguments===  
*'''vehicleToCheck:''' The vehicle that you wish to check is derailed.
*'''vehicleToCheck:''' the [[vehicle]] that you wish to check is derailed.
 


===Returns===
===Returns===
Returns ''true'' if the train is derailed, ''false'' if the train is still on the rails
Returns ''true'' if the train is derailed, ''false'' if the train is still on the rails


==Example==
==Example==
<section name="Example" class="server" show="true">
<section name="Example" class="server" show="true">
This example lets a player check if the train they're driving has derailed.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- TODO
function checkDerailed(thePlayer)
    local theTrain = getPedOccupiedVehicle(thePlayer)
    if ( theTrain and getVehicleType(theTrain) == "Train" ) then --is the player in a vehicle and is it a train?
        if ( isTrainDerailed(theTrain) ) then --is the train derailed?
            outputChatBox("Your train is derailed", thePlayer, 255, 255, 0) --outputs a message
        else
            outputChatBox("Your train is not derailed", thePlayer, 0, 255, 0) --outputs a message
        end
    end
end
addCommandHandler("checkTrain", checkDerailed) --adds the command handler
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>


==See Also==
==See Also==
{{Vehicle_functions}}
{{Vehicle_functions}}

Latest revision as of 01:45, 7 April 2018

This function will check if a train or tram is derailed.

Syntax

bool isTrainDerailed ( vehicle vehicleToCheck )              

OOP Syntax Help! I don't understand this!

Method: vehicle:isDerailed(...)
Variable: .derailed
Counterpart: setTrainDerailed


Required Arguments

  • vehicleToCheck: the vehicle that you wish to check is derailed.

Returns

Returns true if the train is derailed, false if the train is still on the rails

Example

Click to collapse [-]
Example

This example lets a player check if the train they're driving has derailed.

function checkDerailed(thePlayer)
    local theTrain = getPedOccupiedVehicle(thePlayer)
    if ( theTrain and getVehicleType(theTrain) == "Train" ) then --is the player in a vehicle and is it a train?
        if ( isTrainDerailed(theTrain) ) then --is the train derailed?
            outputChatBox("Your train is derailed", thePlayer, 255, 255, 0) --outputs a message
        else
            outputChatBox("Your train is not derailed", thePlayer, 0, 255, 0) --outputs a message
        end
    end
end
addCommandHandler("checkTrain", checkDerailed) --adds the command handler

See Also