roadsConnectedTo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\| *((\[\[[a-zA-Z0-9_ |()]+\]\],? ?)+) * \}\}" to "|seealso= $1 }}")
(formatting)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma2
|game1= arma2


|1.00
|version1= 1.00
 
|game2= arma2oa
 
|version2= 1.51
 
|game3= tkoh
 
|version3= 1.00
 
|game4= arma3
 
|version4= 0.50


|gr1= Roads and Airports
|gr1= Roads and Airports


| Find the road segments connected to the given road segment.
|descr= Find the road segments connected to the given road segment.
{{Feature | important | Pedestrian roads such as <tt>"TRAIL"</tt>s are missing connection information by design, therefore basic command will return empty array for those. Use the alternative syntax to return pedestrian roads.}}
{{Feature |Important|Pedestrian roads such as <tt>"TRAIL"</tt>s are missing connection information by design, therefore basic command will return empty array for those. Use the alternative syntax to return pedestrian roads.}}


| '''roadsConnectedTo''' roadSegment
|s1= '''roadsConnectedTo''' roadSegment


|p1= roadSegment: [[Object]] - road segment
|p1= roadSegment: [[Object]] - Road segment


| [[Array]] of [[Object]]s - connected road segments
|r1= [[Array]] of [[Object]]s - Connected road segments


|s2 = [[roadsConnectedTo]] [roadSegment, extended] {{Since|arma3|1.99.146461|y}}
|s2 = [[roadsConnectedTo]] [roadSegment, extended] {{Since|arma3|2.00|y}}


|p21= roadSegment: [[Object]] - road segment
|p21= roadSegment: [[Object]] - Road segment


|p22= extended: [[Boolean]] - (Optional, default [[false]]) when [[true]], performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments
|p22= extended: [[Boolean]] - (Optional, default [[false]]) When [[true]], performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments


|r2= [[Array]] of [[Object]]s - connected road segments
|r2= [[Array]] of [[Object]]s - Connected road segments


|x1= <code>_road = ([[player]] [[nearRoads]] 50) [[select]] 0;
|x1= <code>_road = ([[player]] [[nearRoads]] 50) [[select]] 0;
Line 32: Line 44:
|seealso= [[nearRoads]], [[isOnRoad]], [[roadAt]], [[surfaceIsWater]], [[getRoadInfo]], [[nearestTerrainObjects]]
|seealso= [[nearRoads]], [[isOnRoad]], [[roadAt]], [[surfaceIsWater]], [[getRoadInfo]], [[nearestTerrainObjects]]
}}
}}
{{GameCategory|arma3|Scripting Commands}}
{{GameCategory|tkoh|Scripting Commands}}

Revision as of 13:41, 26 March 2021

Hover & click on the images for description

Description

Description:
Find the road segments connected to the given road segment.
Pedestrian roads such as "TRAIL"s are missing connection information by design, therefore basic command will return empty array for those. Use the alternative syntax to return pedestrian roads.
Groups:
Roads and Airports

Syntax

Syntax:
roadsConnectedTo roadSegment
Parameters:
roadSegment: Object - Road segment
Return Value:
Array of Objects - Connected road segments

Alternative Syntax

Syntax:
roadsConnectedTo [roadSegment, extended] Template:Since
Parameters:
roadSegment: Object - Road segment
extended: Boolean - (Optional, default false) When true, performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments
Return Value:
Array of Objects - Connected road segments

Examples

Example 1:
_road = (player nearRoads 50) select 0; _connectedRoads = roadsConnectedTo _road;
Example 2:
_road = (player nearRoads 50) select 0; _connectedRoadsIncPedestrian = roadsConnectedTo [_road, true];

Additional Information

See also:
nearRoadsisOnRoadroadAtsurfaceIsWatergetRoadInfonearestTerrainObjects

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note