fml::NativeLibrary Class Reference

#include <native_library.h>

Inheritance diagram for fml::NativeLibrary:

Public Types
using	Handle = void *
using	SymbolHandle = void *

Public Member Functions
template<typename T >
const std::optional< T >	ResolveFunction (const char *symbol)
const uint8_t *	ResolveSymbol (const char *symbol)
Public Member Functions inherited from fml::RefCountedThreadSafe< NativeLibrary >
void	Release () const
Public Member Functions inherited from fml::internal::RefCountedThreadSafeBase
void	AddRef () const
bool	HasOneRef () const
void	AssertHasOneRef () const

Static Public Member Functions
static fml::RefPtr< NativeLibrary >	Create (const char *path)
static fml::RefPtr< NativeLibrary >	CreateWithHandle (Handle handle, bool close_handle_when_done)
static fml::RefPtr< NativeLibrary >	CreateForCurrentProcess ()

Additional Inherited Members
Protected Member Functions inherited from fml::RefCountedThreadSafe< NativeLibrary >
	RefCountedThreadSafe ()
	~RefCountedThreadSafe ()
Protected Member Functions inherited from fml::internal::RefCountedThreadSafeBase
	RefCountedThreadSafeBase ()
	~RefCountedThreadSafeBase ()
bool	Release () const
void	Adopt ()

Detailed Description

Definition at line 20 of file native_library.h.

Member Typedef Documentation

Handle

using fml::NativeLibrary::Handle = void*

Definition at line 26 of file native_library.h.

SymbolHandle

using fml::NativeLibrary::SymbolHandle = void*

Definition at line 27 of file native_library.h.

Member Function Documentation

Create()

fml::RefPtr< NativeLibrary > fml::NativeLibrary::Create ( const char *  path )

static

Definition at line 43 of file native_library_posix.cc.

                                                               {
  auto library = fml::AdoptRef(new NativeLibrary(path));
  return library->GetHandle() != nullptr ? library : nullptr;
}

References fml::AdoptRef().

Referenced by impeller::android::testing::CreateContext(), flutter::GetSymbolMapping(), impeller::android::ProcTable::ProcTable(), flutter::SearchMapping(), flutter::testing::TestVulkanContext::TestVulkanContext(), and flutter::WindowsProcTable::WindowsProcTable().

CreateForCurrentProcess()

fml::RefPtr< NativeLibrary > fml::NativeLibrary::CreateForCurrentProcess ( )

static

Definition at line 56 of file native_library_posix.cc.

                                                                {
  return fml::AdoptRef(new NativeLibrary(RTLD_DEFAULT, false));
}

References fml::AdoptRef().

Referenced by flutter::GetSymbolMapping(), and flutter::SearchMapping().

CreateWithHandle()

fml::RefPtr< NativeLibrary > fml::NativeLibrary::CreateWithHandle ( Handle  handle, bool  close_handle_when_done  )

static

Definition at line 48 of file native_library_posix.cc.

                                 {
  auto library =
      fml::AdoptRef(new NativeLibrary(handle, close_handle_when_done));
  return library->GetHandle() != nullptr ? library : nullptr;
}

References fml::AdoptRef().

Referenced by flutter::LoadDartDeferredLibrary().

ResolveFunction()

template<typename T >

const std::optional< T > fml::NativeLibrary::ResolveFunction ( const char *  symbol )

inline

Definition at line 39 of file native_library.h.

                                                           {
    auto* resolved_symbol = Resolve(symbol);
    if (!resolved_symbol) {
      return std::nullopt;
    }
    return std::optional<T>(reinterpret_cast<T>(resolved_symbol));
  }

Referenced by flutter::WindowsProcTable::WindowsProcTable().

ResolveSymbol()

const uint8_t * fml::NativeLibrary::ResolveSymbol ( const char *  symbol )

inline

Definition at line 47 of file native_library.h.

                                                   {
    auto* resolved_symbol = reinterpret_cast<const uint8_t*>(Resolve(symbol));
    if (resolved_symbol == nullptr) {
      FML_DLOG(INFO) << "Could not resolve symbol in library: " << symbol;
    }
    return resolved_symbol;
  }

References FML_DLOG.

Referenced by vulkan::VulkanProcTable::NativeGetInstanceProcAddr(), and fml::SymbolMapping::SymbolMapping().

---

The documentation for this class was generated from the following files:

• fml/native_library.h
• fml/platform/posix/native_library_posix.cc
• fml/platform/win/native_library_win.cc