Function find_root

Function find_root_locality

hpx::find_root_locality — Return the global id representing the root locality.

Synopsis

// In header: <hpx/hpx_fwd.hpp>


naming::id_type find_root_locality(error_code & ec = throws);

Description

The function find_root_locality() can be used to retrieve the global id usable to refer to the root locality. The root locality is the locality where the main AGAS service is hosted.

	Note
	Generally, the id of a locality can be used for instance to create new instances of components and to invoke plain actions (global functions).

Note

As long as ec is not pre-initialized to hpx::throws this function doesn't throw but returns the result code using the parameter ec. Otherwise it throws an instance of hpx::exception.

This function will return meaningful results only if called from an HPX-thread. It will return hpx::naming::invalid_id otherwise.

See Also:

hpx::find_all_localities(), hpx::find_locality()

Parameters:

`ec`	[in,out] this represents the error status on exit, if this is pre-initialized to hpx::throws the function will throw on error instead.

Returns:

The global id representing the root locality for this application.