{"name":"roadsConnectedTo","operator":null,"title":"roadsConnectedTo","type":"command","url":"https://community.bistudio.com/wiki/roadsConnectedTo","revid":369200,"updated":"2024-09-03T10:34:49Z","groups":["Roads and Airports"],"status":"ok","replaced_by":[],"games":[{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma2","name":"Arma 2","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Find the road segments connected to the given road segment.\n\n> [!IMPORTANT]\n> - Pedestrian roads such as `\"TRAIL\"`s are missing connection information by design, therefore the primary syntax will return empty array for those - use the alternative syntax to return pedestrian roads.\n> - Road connection is not bidirectional; e.g road segment Y can be connected to road segment Z, but road segment Z can lack a connection with road segment Y.","syntaxes":[{"syntax":"roadsConnectedTo roadSegment","since":null,"effect":null,"exec":null,"params":[{"name":"roadSegment","type":"Object","optional":false,"default":null,"description":"road segment","types":["Object"],"since":null,"text":"roadSegment: Object - road segment"}],"returns":{"type":"Array of Objects","types":["Array","Object"],"description":"connected road segments","text":"Array of Objects - connected road segments"},"form":"unary","operator":null,"left":null,"right":{"text":"roadSegment","types":["Object"]}},{"syntax":"roadsConnectedTo [roadSegment, extended]","since":"arma3 2.00","effect":null,"exec":null,"params":[{"name":"roadSegment","type":"Object","optional":false,"default":null,"description":"road segment","types":["Object"],"since":null,"text":"roadSegment: Object - road segment"},{"name":"extended","type":"Boolean","optional":true,"default":"false","description":"when true, performs a more thorough search on top of base behaviour, slower but returns pedestrian and other missing road segments","types":["Boolean"],"since":null,"text":"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"}],"returns":{"type":"Array of Objects","types":["Array","Object"],"description":"connected road segments","text":"Array of Objects - connected road segments"},"form":"unary","operator":null,"left":null,"right":{"text":"[roadSegment, extended]","types":["Array"]}}],"examples":[{"text":"```sqf\n_road = (player nearRoads 50) select 0;\n_connectedRoads = roadsConnectedTo _road;\n```","code":["_road = (player nearRoads 50) select 0;\n_connectedRoads = roadsConnectedTo _road;"]},{"text":"```sqf\n_road = (player nearRoads 50) select 0;\n_connectedRoadsIncPedestrian = roadsConnectedTo [_road, true];\n```","code":["_road = (player nearRoads 50) select 0;\n_connectedRoadsIncPedestrian = roadsConnectedTo [_road, true];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["nearRoads","isOnRoad","roadAt","surfaceIsWater","getRoadInfo","nearestTerrainObjects"],"notes":[],"categories":["Arma 2: New Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Roads and Airports","Introduced with Arma 2 version 1.00","Scripting Commands","Take On Helicopters: Scripting Commands"]}