Ort::Env Struct Reference

The Env (Environment) More...

#include <onnxruntime_cxx_api.h>

Inheritance diagram for Ort::Env:

Public Member Functions
	Env (std::nullptr_t)
	Create an empty Env object, must be assigned a valid one to be used.
	Env (OrtLoggingLevel logging_level=ORT_LOGGING_LEVEL_WARNING, const char *logid="")
	Wraps OrtApi::CreateEnv.
	Env (OrtLoggingLevel logging_level, const char *logid, OrtLoggingFunction logging_function, void *logger_param)
	Wraps OrtApi::CreateEnvWithCustomLogger.
	Env (const OrtThreadingOptions *tp_options, OrtLoggingLevel logging_level=ORT_LOGGING_LEVEL_WARNING, const char *logid="")
	Wraps OrtApi::CreateEnvWithGlobalThreadPools.
	Env (const OrtThreadingOptions *tp_options, OrtLoggingFunction logging_function, void *logger_param, OrtLoggingLevel logging_level=ORT_LOGGING_LEVEL_WARNING, const char *logid="")
	Wraps OrtApi::CreateEnvWithCustomLoggerAndGlobalThreadPools.
	Env (OrtEnv *p)
	C Interop Helper.
Env &	EnableTelemetryEvents ()
	Wraps OrtApi::EnableTelemetryEvents.
Env &	DisableTelemetryEvents ()
	Wraps OrtApi::DisableTelemetryEvents.
Env &	UpdateEnvWithCustomLogLevel (OrtLoggingLevel log_severity_level)
	Wraps OrtApi::UpdateEnvWithCustomLogLevel.
Env &	CreateAndRegisterAllocator (const OrtMemoryInfo *mem_info, const OrtArenaCfg *arena_cfg)
	Wraps OrtApi::CreateAndRegisterAllocator.
Env &	CreateAndRegisterAllocatorV2 (const std::string &provider_type, const OrtMemoryInfo *mem_info, const std::unordered_map< std::string, std::string > &options, const OrtArenaCfg *arena_cfg)
	Wraps OrtApi::CreateAndRegisterAllocatorV2.
Env &	RegisterAllocator (OrtAllocator *allocator)
	Wraps OrtApi::RegisterAllocator.
Env &	UnregisterAllocator (const OrtMemoryInfo *mem_info)
	Wraps OrtApi::UnregisterAllocator.
UnownedAllocator	CreateSharedAllocator (const OrtEpDevice *ep_device, OrtDeviceMemoryType mem_type, OrtAllocatorType allocator_type, const OrtKeyValuePairs *allocator_options)
	Wraps OrtApi::CreateSharedAllocator.
UnownedAllocator	GetSharedAllocator (const OrtMemoryInfo *mem_info)
	Wraps OrtApi::GetSharedAllocator.
void	ReleaseSharedAllocator (const OrtEpDevice *ep_device, OrtDeviceMemoryType mem_type)
	Wraps OrtApi::ReleaseSharedAllocator.
Env &	RegisterExecutionProviderLibrary (const char *registration_name, const std::basic_string< char > &path)
	Wraps OrtApi::RegisterExecutionProviderLibrary.
Env &	UnregisterExecutionProviderLibrary (const char *registration_name)
	Wraps OrtApi::UnregisterExecutionProviderLibrary.
std::vector< ConstEpDevice >	GetEpDevices () const
Status	CopyTensors (const std::vector< Value > &src_tensors, const std::vector< Value > &dst_tensors, OrtSyncStream *stream) const
	Wraps OrtApi::CopyTensors.
Public Member Functions inherited from Ort::detail::Base< OrtEnv >
constexpr	Base ()=default
constexpr	Base (contained_type *p) noexcept
	Base (const Base &)=delete
	Base (Base &&v) noexcept
	~Base ()
Base &	operator= (const Base &)=delete
Base &	operator= (Base &&v) noexcept
constexpr	operator contained_type * () const noexcept
constexpr contained_type &	operator* () const noexcept
contained_type *	release ()
	Relinquishes ownership of the contained C object pointer The underlying object is not destroyed.

Additional Inherited Members
Public Types inherited from Ort::detail::Base< OrtEnv >
using	contained_type = OrtEnv
Protected Attributes inherited from Ort::detail::Base< OrtEnv >
contained_type *	p_

Detailed Description

The Env (Environment)

The Env holds the logging state used by all other objects. Note: One Env must be created before using any other Onnxruntime functionality

Constructor & Destructor Documentation

Env() [1/6]

Ort::Env::Env ( std::nullptr_t  )

inlineexplicit

Create an empty Env object, must be assigned a valid one to be used.

Env() [2/6]

Ort::Env::Env	(	OrtLoggingLevel	logging_level = ORT_LOGGING_LEVEL_WARNING,
		const char *	logid = ""
	)

Wraps OrtApi::CreateEnv.

Env() [3/6]

Ort::Env::Env	(	OrtLoggingLevel	logging_level,
		const char *	logid,
		OrtLoggingFunction	logging_function,
		void *	logger_param
	)

Wraps OrtApi::CreateEnvWithCustomLogger.

Env() [4/6]

Ort::Env::Env	(	const OrtThreadingOptions *	tp_options,
		OrtLoggingLevel	logging_level = ORT_LOGGING_LEVEL_WARNING,
		const char *	logid = ""
	)

Wraps OrtApi::CreateEnvWithGlobalThreadPools.

Env() [5/6]

Ort::Env::Env	(	const OrtThreadingOptions *	tp_options,
		OrtLoggingFunction	logging_function,
		void *	logger_param,
		OrtLoggingLevel	logging_level = ORT_LOGGING_LEVEL_WARNING,
		const char *	logid = ""
	)

Wraps OrtApi::CreateEnvWithCustomLoggerAndGlobalThreadPools.

Env() [6/6]

Ort::Env::Env ( OrtEnv *  p )

inlineexplicit

C Interop Helper.

Member Function Documentation

CopyTensors()

Status Ort::Env::CopyTensors	(	const std::vector< Value > &	src_tensors,
		const std::vector< Value > &	dst_tensors,
		OrtSyncStream *	stream
	)		const

Wraps OrtApi::CopyTensors.

CreateAndRegisterAllocator()

Env & Ort::Env::CreateAndRegisterAllocator	(	const OrtMemoryInfo *	mem_info,
		const OrtArenaCfg *	arena_cfg
	)

Wraps OrtApi::CreateAndRegisterAllocator.

CreateAndRegisterAllocatorV2()

Env & Ort::Env::CreateAndRegisterAllocatorV2	(	const std::string &	provider_type,
		const OrtMemoryInfo *	mem_info,
		const std::unordered_map< std::string, std::string > &	options,
		const OrtArenaCfg *	arena_cfg
	)

Wraps OrtApi::CreateAndRegisterAllocatorV2.

CreateSharedAllocator()

UnownedAllocator Ort::Env::CreateSharedAllocator	(	const OrtEpDevice *	ep_device,
		OrtDeviceMemoryType	mem_type,
		OrtAllocatorType	allocator_type,
		const OrtKeyValuePairs *	allocator_options
	)

Wraps OrtApi::CreateSharedAllocator.

DisableTelemetryEvents()

Env & Ort::Env::DisableTelemetryEvents

(

)

Wraps OrtApi::DisableTelemetryEvents.

EnableTelemetryEvents()

Env & Ort::Env::EnableTelemetryEvents

(

)

Wraps OrtApi::EnableTelemetryEvents.

GetEpDevices()

std::vector< ConstEpDevice > Ort::Env::GetEpDevices

(

)

const

GetSharedAllocator()

UnownedAllocator Ort::Env::GetSharedAllocator

(

const OrtMemoryInfo *

mem_info

)

Wraps OrtApi::GetSharedAllocator.

RegisterAllocator()

Env & Ort::Env::RegisterAllocator

(

OrtAllocator *

allocator

)

Wraps OrtApi::RegisterAllocator.

RegisterExecutionProviderLibrary()

Env & Ort::Env::RegisterExecutionProviderLibrary	(	const char *	registration_name,
		const std::basic_string< char > &	path
	)

Wraps OrtApi::RegisterExecutionProviderLibrary.

ReleaseSharedAllocator()

void Ort::Env::ReleaseSharedAllocator	(	const OrtEpDevice *	ep_device,
		OrtDeviceMemoryType	mem_type
	)

Wraps OrtApi::ReleaseSharedAllocator.

UnregisterAllocator()

Env & Ort::Env::UnregisterAllocator

(

const OrtMemoryInfo *

mem_info

)

Wraps OrtApi::UnregisterAllocator.

UnregisterExecutionProviderLibrary()

Env & Ort::Env::UnregisterExecutionProviderLibrary

(

const char *

registration_name

)

Wraps OrtApi::UnregisterExecutionProviderLibrary.

UpdateEnvWithCustomLogLevel()

Env & Ort::Env::UpdateEnvWithCustomLogLevel

(

OrtLoggingLevel

log_severity_level

)

Wraps OrtApi::UpdateEnvWithCustomLogLevel.