getCurrentBackend#

Fully qualified name: isaacsim::foundation::utils::getCurrentBackend

std::string isaacsim::foundation::utils::getCurrentBackend(
const std::vector<std::string> &supportedBackends,
std::optional<bool> raiseOnUnsupported = std::nullopt,
)#

Returns the currently active backend name for this thread.

Vector overload of getCurrentBackend for callers with a runtime-determined backend list. Behavior is identical to the initializer_list overload.

Parameters:
  • supportedBackends – [in] Ordered list of backend names accepted by the caller.

  • raiseOnUnsupported – [in] Override for the raise-on-unsupported flag.

Throws:
  • std::invalid_argument – If supportedBackends is empty.

  • std::runtime_error – If the active backend is unsupported and raising is enabled.

Returns:

The active backend name, or the first entry of supportedBackends as fallback.