GetElementsWithinRange: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Created page with "{{Server client function}} __NOTOC__ This function is used to retrieve a list of all elements within a range of 3D coordinates. Please note that this function doesn't verify...")
 
mNo edit summary
Line 2: Line 2:
__NOTOC__
__NOTOC__
This function is used to retrieve a list of all elements within a range of 3D coordinates.
This function is used to retrieve a list of all elements within a range of 3D coordinates.
 
{{Note|This function doesn't verify whether elements are in the same dimension and interior, additional checks could be implemented manually if they are needed}}
Please note that this function doesn't verify whether elements are in the same dimension and interior, additional checks could be implemented manually if they are needed.


==Syntax==  
==Syntax==  

Revision as of 05:44, 29 July 2018

This function is used to retrieve a list of all elements within a range of 3D coordinates.

[[{{{image}}}|link=|]] Note: This function doesn't verify whether elements are in the same dimension and interior, additional checks could be implemented manually if they are needed

Syntax

table getElementsWithinRange ( float x, float y, float z, float range ) 

OOP Syntax Help! I don't understand this!

Method: Element.getWithinRange(...)


Required Arguments

  • x: the x coordinate at which to retrieve elements
  • y: the y coordinate at which to retrieve elements
  • z: the z coordinate at which to retrieve elements
  • range: the range at the coordinates in which to retrieve elements

Returns

Returns a table containing all the elements within range. Returns an empty table if there are no elements within range. Returns false if the arguments are invalid.

Example

This example retrieves a table of players within range of the 3D coordinates and prints their name to the chat.

local elements = getElementsWithinRange( 0, 0, 3, 20 )                    -- get all elements within 20 units of 0, 0, 3
for _, element in ipairs( elements ) do                                   -- use a generic for loop to step through each player
    if ( getElementType( element ) == "player" ) then                     -- if the element is a player
        outputChatBox( getPlayerName( element ) .. " is within range" ) -- print their name to the chat
    end
end

See Also