hpx::find_root_locality, hpx::find_all_localities, hpx::find_remote_localities
hpx::find_root_locality, hpx::find_all_localities, hpx::find_remote_localities#
Defined in header hpx/runtime.hpp.
See Public API for a list of names and headers that are part of the public HPX API.
-
namespace hpx
Functions
-
hpx::id_type find_root_locality(error_code &ec = throws)#
Return the global id representing the root locality.
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.
Note
This function will return meaningful results only if called from an HPX-thread. It will return hpx::invalid_id otherwise.
- 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.
-
std::vector<hpx::id_type> find_all_localities(error_code &ec = throws)#
Return the list of global ids representing all localities available to this application.
The function find_all_localities() can be used to retrieve the global ids of all localities currently available to this application.
See also
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.
Note
This function will return meaningful results only if called from an HPX-thread. It will return an empty vector otherwise.
- 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 ids representing the localities currently available to this application.
-
std::vector<hpx::id_type> find_remote_localities(error_code &ec = throws)#
Return the list of locality ids of remote localities supporting the given component type. By default this function will return the list of all remote localities (all but the current locality).
The function find_remote_localities() can be used to retrieve the global ids of all remote localities currently available to this application (i.e. all localities except the current one).
See also
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.
Note
This function will return meaningful results only if called from an HPX-thread. It will return an empty vector otherwise.
- 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 ids representing the remote localities currently available to this application.
-
hpx::id_type find_root_locality(error_code &ec = throws)#