#include <object.h>

Inheritance diagram for dart::Library:

Public Member Functions
StringPtr	name () const

void	SetName (const String &name) const

StringPtr	url () const

StringPtr	private_key () const

bool	LoadNotStarted () const

bool	LoadRequested () const

bool	LoadInProgress () const

void	SetLoadRequested () const

void	SetLoadInProgress () const

bool	Loaded () const

void	SetLoaded () const

LoadingUnitPtr	loading_unit () const

void	set_loading_unit (const LoadingUnit &value) const

ObjectPtr	Invoke (const String &selector, const Array &arguments, const Array &argument_names, bool respect_reflectable=true, bool check_is_entrypoint=false) const

ObjectPtr	InvokeGetter (const String &selector, bool throw_nsm_if_absent, bool respect_reflectable=true, bool check_is_entrypoint=false) const

ObjectPtr	InvokeSetter (const String &selector, const Instance &argument, bool respect_reflectable=true, bool check_is_entrypoint=false) const

ObjectPtr	EvaluateCompiledExpression (const ExternalTypedData &kernel_buffer, const Array &type_definitions, const Array &param_values, const TypeArguments &type_param_values) const

void	AddClass (const Class &cls) const

void	AddObject (const Object &obj, const String &name) const

ObjectPtr	LookupReExport (const String &name, ZoneGrowableArray< intptr_t > *visited=nullptr) const

ObjectPtr	LookupLocalOrReExportObject (const String &name) const

LibraryPrefixPtr	LookupLocalLibraryPrefix (const String &name) const

ClassPtr	LookupClass (const String &name) const

ClassPtr	LookupClassAllowPrivate (const String &name) const

FieldPtr	LookupFieldAllowPrivate (const String &name) const

FunctionPtr	LookupFunctionAllowPrivate (const String &name) const

ScriptPtr	LookupScript (const String &url, bool useResolvedUri=false) const

ArrayPtr	LoadedScripts () const

void	AddExport (const Namespace &ns) const

void	AddMetadata (const Object &declaration, intptr_t kernel_offset) const

ObjectPtr	GetMetadata (const Object &declaration) const

void	EvaluatePragmas ()

void	CopyPragmas (const Library &old_lib)

ClassPtr	toplevel_class () const

void	set_toplevel_class (const Class &value) const

GrowableObjectArrayPtr	used_scripts () const

ArrayPtr	imports () const

ArrayPtr	exports () const

void	AddImport (const Namespace &ns) const

intptr_t	num_imports () const

NamespacePtr	ImportAt (intptr_t index) const

LibraryPtr	ImportLibraryAt (intptr_t index) const

ArrayPtr	dependencies () const

void	set_dependencies (const Array &deps) const

void	DropDependenciesAndCaches () const

Dart_NativeEntryResolver	native_entry_resolver () const

void	set_native_entry_resolver (Dart_NativeEntryResolver value) const

Dart_NativeEntrySymbol	native_entry_symbol_resolver () const

void	set_native_entry_symbol_resolver (Dart_NativeEntrySymbol native_symbol_resolver) const

Dart_FfiNativeResolver	ffi_native_resolver () const

void	set_ffi_native_resolver (Dart_FfiNativeResolver value) const

bool	is_in_fullsnapshot () const

void	set_is_in_fullsnapshot (bool value) const

StringPtr	PrivateName (const String &name) const

intptr_t	index () const

void	set_index (intptr_t value) const

void	Register (Thread *thread) const

bool	IsDebuggable () const

void	set_debuggable (bool value) const

bool	is_dart_scheme () const

void	set_is_dart_scheme (bool value) const

bool	IsAnyCoreLibrary () const

intptr_t	UrlHash () const

KernelProgramInfoPtr	kernel_program_info () const

void	set_kernel_program_info (const KernelProgramInfo &info) const

TypedDataViewPtr	KernelLibrary () const

intptr_t	KernelLibraryOffset () const

intptr_t	kernel_library_index () const

void	set_kernel_library_index (intptr_t value) const

void	CheckReload (const Library &replacement, ProgramReloadContext *context) const

ObjectPtr	GetFunctionClosure (const String &name) const

void	EnsureTopLevelClassIsFinalized () const

Public Member Functions inherited from dart::Object
virtual	~Object ()

ObjectPtr	ptr () const

void	operator= (ObjectPtr value)

bool	IsCanonical () const

void	SetCanonical () const

void	ClearCanonical () const

bool	IsImmutable () const

void	SetImmutable () const

void	ClearImmutable () const

intptr_t	GetClassId () const

ClassPtr	clazz () const

	CLASS_LIST_FOR_HANDLES (DEFINE_CLASS_TESTER)

bool	IsNull () const

virtual const char *	ToCString () const

void	PrintJSON (JSONStream *stream, bool ref=true) const

virtual void	PrintJSONImpl (JSONStream *stream, bool ref) const

void	PrintImplementationFields (JSONStream *stream) const

virtual void	PrintImplementationFieldsImpl (const JSONArray &jsarr_fields) const

virtual const char *	JSONType () const

virtual StringPtr	DictionaryName () const

bool	IsNew () const

bool	IsOld () const

bool	InVMIsolateHeap () const

void	Print () const

Static Public Member Functions
static StringPtr	UrlOf (LibraryPtr lib)

static intptr_t	InstanceSize ()

static LibraryPtr	New (const String &url)

static bool	FindPragma (Thread T, bool only_core, const Object &object, const String &pragma_name, bool multiple=false, Object options=nullptr)

static void	RegisterLibraries (Thread *thread, const GrowableObjectArray &libs)

static LibraryPtr	LookupLibrary (Thread *thread, const String &url)

static LibraryPtr	GetLibrary (intptr_t index)

static void	InitCoreLibrary (IsolateGroup *isolate_group)

static void	InitNativeWrappersLibrary (IsolateGroup *isolate_group, bool is_kernel_file)

static LibraryPtr	AsyncLibrary ()

static LibraryPtr	ConvertLibrary ()

static LibraryPtr	CoreLibrary ()

static LibraryPtr	CollectionLibrary ()

static LibraryPtr	DeveloperLibrary ()

static LibraryPtr	FfiLibrary ()

static LibraryPtr	InternalLibrary ()

static LibraryPtr	IsolateLibrary ()

static LibraryPtr	MathLibrary ()

static LibraryPtr	MirrorsLibrary ()

static LibraryPtr	NativeWrappersLibrary ()

static LibraryPtr	TypedDataLibrary ()

static LibraryPtr	VMServiceLibrary ()

static ErrorPtr	CompileAll (bool ignore_error=false)

static ErrorPtr	FinalizeAllClasses ()

static bool	IsPrivate (const String &name)

static const String &	PrivateCoreLibName (const String &member)

static bool	IsPrivateCoreLibName (const String &name, const String &member)

static ClassPtr	LookupCoreClass (const String &class_name)

static FunctionPtr	GetFunction (const GrowableArray< Library * > &libs, const char class_name, const char function_name)

Static Public Member Functions inherited from dart::Object
static ObjectPtr	RawCast (ObjectPtr obj)

static constexpr bool	ContainsCompressedPointers ()

static intptr_t	tags_offset ()

static Object &	Handle ()

static Object &	Handle (Zone *zone)

static Object &	Handle (ObjectPtr ptr)

static Object &	Handle (Zone *zone, ObjectPtr ptr)

static Object &	ZoneHandle ()

static Object &	ZoneHandle (Zone *zone)

static Object &	ZoneHandle (ObjectPtr ptr)

static Object &	ZoneHandle (Zone *zone, ObjectPtr ptr)

static Object *	ReadOnlyHandle ()

static ObjectPtr	null ()

static void	set_vm_isolate_snapshot_object_table (const Array &table)

static ClassPtr	class_class ()

static ClassPtr	dynamic_class ()

static ClassPtr	void_class ()

static ClassPtr	type_parameters_class ()

static ClassPtr	type_arguments_class ()

static ClassPtr	patch_class_class ()

static ClassPtr	function_class ()

static ClassPtr	closure_data_class ()

static ClassPtr	ffi_trampoline_data_class ()

static ClassPtr	field_class ()

static ClassPtr	script_class ()

static ClassPtr	library_class ()

static ClassPtr	namespace_class ()

static ClassPtr	kernel_program_info_class ()

static ClassPtr	code_class ()

static ClassPtr	instructions_class ()

static ClassPtr	instructions_section_class ()

static ClassPtr	instructions_table_class ()

static ClassPtr	object_pool_class ()

static ClassPtr	pc_descriptors_class ()

static ClassPtr	code_source_map_class ()

static ClassPtr	compressed_stackmaps_class ()

static ClassPtr	var_descriptors_class ()

static ClassPtr	exception_handlers_class ()

static ClassPtr	context_class ()

static ClassPtr	context_scope_class ()

static ClassPtr	sentinel_class ()

static ClassPtr	api_error_class ()

static ClassPtr	language_error_class ()

static ClassPtr	unhandled_exception_class ()

static ClassPtr	unwind_error_class ()

static ClassPtr	singletargetcache_class ()

static ClassPtr	unlinkedcall_class ()

static ClassPtr	monomorphicsmiablecall_class ()

static ClassPtr	icdata_class ()

static ClassPtr	megamorphic_cache_class ()

static ClassPtr	subtypetestcache_class ()

static ClassPtr	loadingunit_class ()

static ClassPtr	weak_serialization_reference_class ()

static ClassPtr	weak_array_class ()

static void	InitNullAndBool (IsolateGroup *isolate_group)

static void	Init (IsolateGroup *isolate_group)

static void	InitVtables ()

static void	FinishInit (IsolateGroup *isolate_group)

static void	FinalizeVMIsolate (IsolateGroup *isolate_group)

static void	FinalizeReadOnlyObject (ObjectPtr object)

static void	Cleanup ()

static ErrorPtr	Init (IsolateGroup isolate_group, const uint8_t kernel_buffer, intptr_t kernel_buffer_size)

static void	MakeUnusedSpaceTraversable (const Object &obj, intptr_t original_size, intptr_t used_size)

static intptr_t	InstanceSize ()

template<class FakeObject >
static void	VerifyBuiltinVtable (intptr_t cid)

static void	VerifyBuiltinVtables ()

static bool	ShouldHaveImmutabilityBitSet (classid_t class_id)

Static Public Attributes
static const char	kPrivateIdentifierStart = '_'

static const char	kPrivateKeySeparator = '@'

Static Public Attributes inherited from dart::Object
static constexpr intptr_t	kHashBits = 30

static const ClassId	kClassId = kObjectCid

Friends
class	Bootstrap

class	Class

class	Debugger

class	DictionaryIterator

class	Isolate

class	LibraryDeserializationCluster

class	Namespace

class	Object

class	Precompiler

Additional Inherited Members
Public Types inherited from dart::Object
enum	NameVisibility { kInternalName = 0 , kScrubbedName , kUserVisibleName }

enum class	NameDisambiguation { kYes , kNo }

using	UntaggedObjectType = UntaggedObject

using	ObjectPtrType = ObjectPtr

Protected Member Functions inherited from dart::Object
	Object ()

uword	raw_value () const

void	setPtr (ObjectPtr value, intptr_t default_cid)

void	CheckHandle () const

cpp_vtable	vtable () const

void	set_vtable (cpp_vtable value)

bool	Contains (uword addr) const

template<typename type , std::memory_order order = std::memory_order_relaxed>
type	LoadPointer (type const *addr) const

template<typename type , std::memory_order order = std::memory_order_relaxed>
void	StorePointer (type const *addr, type value) const

template<typename type , typename compressed_type , std::memory_order order = std::memory_order_relaxed>
void	StoreCompressedPointer (compressed_type const *addr, type value) const

template<typename type >
void	StorePointerUnaligned (type const addr, type value, Thread thread) const

void	StoreSmi (SmiPtr const *addr, SmiPtr value) const

template<typename FieldType >
void	StoreSimd128 (const FieldType *addr, simd128_value_t value) const

template<typename FieldType >
FieldType	LoadNonPointer (const FieldType *addr) const

template<typename FieldType , std::memory_order order>
FieldType	LoadNonPointer (const FieldType *addr) const

template<typename FieldType , typename ValueType >
void	StoreNonPointer (const FieldType *addr, ValueType value) const

template<typename FieldType , typename ValueType , std::memory_order order>
void	StoreNonPointer (const FieldType *addr, ValueType value) const

template<typename FieldType >
FieldType *	UnsafeMutableNonPointer (const FieldType *addr) const

	CLASS_LIST (STORE_NON_POINTER_ILLEGAL_TYPE)

void	UnimplementedMethod () const

void	AddCommonObjectProperties (JSONObject jsobj, const char protocol_type, bool ref) const

Static Protected Member Functions inherited from dart::Object
static DART_NOINLINE Object &	HandleImpl (Zone *zone, ObjectPtr ptr, intptr_t default_cid)

static DART_NOINLINE Object &	ZoneHandleImpl (Zone *zone, ObjectPtr ptr, intptr_t default_cid)

static DART_NOINLINE Object *	ReadOnlyHandleImpl (intptr_t cid)

static ObjectPtr	Allocate (intptr_t cls_id, intptr_t size, Heap::Space space, bool compressed, uword ptr_field_start_offset, uword ptr_field_end_offset)

template<typename T >
static DART_FORCE_INLINE T::ObjectPtrType	Allocate (Heap::Space space)

template<typename T >
static DART_FORCE_INLINE T::ObjectPtrType	Allocate (Heap::Space space, intptr_t elements)

template<typename T >
static DART_FORCE_INLINE T::ObjectPtrType	AllocateVariant (intptr_t class_id, Heap::Space space)

template<typename T >
static DART_FORCE_INLINE T::ObjectPtrType	AllocateVariant (intptr_t class_id, Heap::Space space, intptr_t elements)

static constexpr intptr_t	RoundedAllocationSize (intptr_t size)

static ObjectPtr	Clone (const Object &orig, Heap::Space space, bool load_with_relaxed_atomics=false)

template<typename T >
static DART_FORCE_INLINE uword	from_offset ()

template<typename T >
static DART_FORCE_INLINE uword	to_offset (intptr_t length=0)

Protected Attributes inherited from dart::Object
ObjectPtr	ptr_

Detailed Description

Definition at line 5063 of file object.h.

Member Function Documentation

◆ AddClass()

void dart::Library::AddClass ( const Class & cls ) const

Definition at line 13961 of file object.cc.

                                             {
  ASSERT(!Compiler::IsBackgroundCompilation());
  const String& class_name = String::Handle(cls.Name());
  AddObject(cls, class_name);
  // Link class to this library.
  cls.set_library(*this);
}

◆ AddExport()

void dart::Library::AddExport ( const Namespace & ns ) const

Definition at line 14243 of file object.cc.

                                                 {
  Array& exports = Array::Handle(this->exports());
  intptr_t num_exports = exports.Length();
  exports = Array::Grow(exports, num_exports + 1);
  untag()->set_exports(exports.ptr());
  exports.SetAt(num_exports, ns);
}

◆ AddImport()

void dart::Library::AddImport ( const Namespace & ns ) const

Definition at line 14221 of file object.cc.

                                                 {
  Array& imports = Array::Handle(this->imports());
  intptr_t capacity = imports.Length();
  if (num_imports() == capacity) {
    capacity = capacity + kImportsCapacityIncrement + (capacity >> 2);
    imports = Array::Grow(imports, capacity);
    untag()->set_imports(imports.ptr());
  }
  intptr_t index = num_imports();
  imports.SetAt(index, ns);
  set_num_imports(index + 1);
}

◆ AddMetadata()

void dart::Library::AddMetadata	(	const Object &	declaration,
		intptr_t	kernel_offset
	)		const

Definition at line 13687 of file object.cc.

                                                        {
#if defined(DART_PRECOMPILED_RUNTIME)
  UNREACHABLE();
#else
  Thread* thread = Thread::Current();
  ASSERT(thread->isolate_group()->program_lock()->IsCurrentThreadWriter());
 
  MetadataMap map(metadata());
  map.UpdateOrInsert(declaration, Smi::Handle(Smi::New(kernel_offset)));
  set_metadata(map.Release());
#endif  // defined(DART_PRECOMPILED_RUNTIME)
}

◆ AddObject()

void dart::Library::AddObject	(	const Object &	obj,
		const String &	name
	)		const

Definition at line 13862 of file object.cc.

                                                                   {
  ASSERT(Thread::Current()->IsDartMutatorThread());
  ASSERT(obj.IsClass() || obj.IsFunction() || obj.IsField() ||
         obj.IsLibraryPrefix());
  ASSERT(name.Equals(String::Handle(obj.DictionaryName())));
  ASSERT(LookupLocalObject(name) == Object::null());
  const Array& dict = Array::Handle(dictionary());
  intptr_t dict_size = dict.Length() - 1;
  intptr_t index = name.Hash() % dict_size;
 
  Object& entry = Object::Handle();
  entry = dict.At(index);
  // An empty spot will be found because we keep the hash set at most 75% full.
  while (!entry.IsNull()) {
    index = (index + 1) % dict_size;
    entry = dict.At(index);
  }
 
  // Insert the object at the empty slot.
  dict.SetAt(index, obj);
  // One more element added.
  intptr_t used_elements = Smi::Value(Smi::RawCast(dict.At(dict_size))) + 1;
  const Smi& used = Smi::Handle(Smi::New(used_elements));
  dict.SetAt(dict_size, used);  // Update used count.
 
  // Rehash if symbol_table is 75% full.
  if (used_elements > ((dict_size / 4) * 3)) {
    // TODO(iposva): Avoid exponential growth.
    RehashDictionary(dict, 2 * dict_size);
  }
 
  // Invalidate the cache of loaded scripts.
  if (loaded_scripts() != Array::null()) {
    untag()->set_loaded_scripts(Array::null());
  }
}

◆ AsyncLibrary()

LibraryPtr dart::Library::AsyncLibrary ( )

static

Definition at line 14826 of file object.cc.

                                 {
  return IsolateGroup::Current()->object_store()->async_library();
}

◆ CheckReload()

void dart::Library::CheckReload	(	const Library &	replacement,
		ProgramReloadContext *	context
	)		const

Definition at line 733 of file object_reload.cc.

                                                               {
  // Carry over the loaded bit of any deferred prefixes.
  Object& object = Object::Handle();
  LibraryPrefix& prefix = LibraryPrefix::Handle();
  LibraryPrefix& original_prefix = LibraryPrefix::Handle();
  String& name = String::Handle();
  String& original_name = String::Handle();
  DictionaryIterator it(replacement);
  while (it.HasNext()) {
    object = it.GetNext();
    if (!object.IsLibraryPrefix()) continue;
    prefix ^= object.ptr();
    if (!prefix.is_deferred_load()) continue;
 
    name = prefix.name();
    DictionaryIterator original_it(*this);
    while (original_it.HasNext()) {
      object = original_it.GetNext();
      if (!object.IsLibraryPrefix()) continue;
      original_prefix ^= object.ptr();
      if (!original_prefix.is_deferred_load()) continue;
      original_name = original_prefix.name();
      if (!name.Equals(original_name)) continue;
 
      // The replacement of the old prefix with the new prefix
      // in Isolate::loaded_prefixes_set_ implicitly carried
      // the loaded state over to the new prefix.
      context->AddBecomeMapping(original_prefix, prefix);
    }
  }
}

◆ CollectionLibrary()

LibraryPtr dart::Library::CollectionLibrary ( )

static

Definition at line 14838 of file object.cc.

                                      {
  return IsolateGroup::Current()->object_store()->collection_library();
}

◆ CompileAll()

ErrorPtr dart::Library::CompileAll ( bool ignore_error = false )

static

Definition at line 15275 of file object.cc.

                                                {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  Error& error = Error::Handle(zone);
  const GrowableObjectArray& libs = GrowableObjectArray::Handle(
      IsolateGroup::Current()->object_store()->libraries());
  Library& lib = Library::Handle(zone);
  Class& cls = Class::Handle(zone);
  for (int i = 0; i < libs.Length(); i++) {
    lib ^= libs.At(i);
    ClassDictionaryIterator it(lib, ClassDictionaryIterator::kIteratePrivate);
    while (it.HasNext()) {
      cls = it.GetNextClass();
      error = cls.EnsureIsFinalized(thread);
      if (!error.IsNull()) {
        if (ignore_error) continue;
        return error.ptr();
      }
      error = Compiler::CompileAllFunctions(cls);
      if (!error.IsNull()) {
        if (ignore_error) continue;
        return error.ptr();
      }
    }
  }
 
  Object& result = Object::Handle(zone);
  ClosureFunctionsCache::ForAllClosureFunctions([&](const Function& func) {
    if (!func.HasCode()) {
      result = Compiler::CompileFunction(thread, func);
      if (result.IsError()) {
        error = Error::Cast(result).ptr();
        return false;  // Stop iteration.
      }
    }
    return true;  // Continue iteration.
  });
  return error.ptr();
}

◆ ConvertLibrary()

LibraryPtr dart::Library::ConvertLibrary ( )

static

Definition at line 14830 of file object.cc.

                                   {
  return IsolateGroup::Current()->object_store()->convert_library();
}

◆ CopyPragmas()

void dart::Library::CopyPragmas ( const Library & old_lib )

Definition at line 13792 of file object.cc.

                                                {
  auto thread = Thread::Current();
  SafepointWriteRwLocker ml(thread, thread->isolate_group()->program_lock());
  MetadataMap new_map(metadata());
  MetadataMap old_map(old_lib.metadata());
  Object& declaration = Object::Handle();
  Object& value = Object::Handle();
  MetadataMap::Iterator it(&old_map);
  while (it.MoveNext()) {
    const intptr_t entry = it.Current();
    ASSERT(entry != -1);
    declaration = old_map.GetKey(entry);
    if (HasPragma(declaration)) {
      value = old_map.GetPayload(entry, 0);
      ASSERT(!value.IsNull());
      // Pragmas should be evaluated during hot reload phase 1
      // (when checkpointing libraries).
      ASSERT(!value.IsSmi());
      new_map.UpdateOrInsert(declaration, value);
    }
  }
  old_lib.set_metadata(old_map.Release());
  set_metadata(new_map.Release());
}

◆ CoreLibrary()

LibraryPtr dart::Library::CoreLibrary ( )

static

Definition at line 14834 of file object.cc.

                                {
  return IsolateGroup::Current()->object_store()->core_library();
}

◆ dependencies()

ArrayPtr dart::Library::dependencies ( ) const

inline

Definition at line 5194 of file object.h.

5194{ return untag()->dependencies(); }

◆ DeveloperLibrary()

LibraryPtr dart::Library::DeveloperLibrary ( )

static

Definition at line 14842 of file object.cc.

                                     {
  return IsolateGroup::Current()->object_store()->developer_library();
}

◆ DropDependenciesAndCaches()

void dart::Library::DropDependenciesAndCaches ( ) const

Definition at line 14209 of file object.cc.

                                              {
  untag()->set_imports(Object::empty_array().ptr());
  untag()->set_exports(Object::empty_array().ptr());
  StoreNonPointer(&untag()->num_imports_, 0);
  untag()->set_loaded_scripts(Array::null());
  untag()->set_dependencies(Array::null());
#if defined(PRODUCT)
  // used_scripts is only used by vm-service.
  untag()->set_used_scripts(GrowableObjectArray::null());
#endif
}

◆ EnsureTopLevelClassIsFinalized()

void dart::Library::EnsureTopLevelClassIsFinalized ( ) const

Definition at line 14091 of file object.cc.

                                                   {
  if (toplevel_class() == Object::null()) {
    return;
  }
  Thread* thread = Thread::Current();
  const Class& cls = Class::Handle(thread->zone(), toplevel_class());
  if (cls.is_finalized()) {
    return;
  }
  const Error& error =
      Error::Handle(thread->zone(), cls.EnsureIsFinalized(thread));
  if (!error.IsNull()) {
    Exceptions::PropagateError(error);
  }
}

◆ EvaluateCompiledExpression()

ObjectPtr dart::Library::EvaluateCompiledExpression	(	const ExternalTypedData &	kernel_buffer,
		const Array &	type_definitions,
		const Array &	param_values,
		const TypeArguments &	type_param_values
	)		const

Definition at line 4866 of file object.cc.

                                               {
  const auto& klass = Class::Handle(toplevel_class());
  return klass.EvaluateCompiledExpression(kernel_buffer, type_definitions,
                                          arguments, type_arguments);
}

◆ EvaluatePragmas()

void dart::Library::EvaluatePragmas ( )

Definition at line 13767 of file object.cc.

                              {
  Object& declaration = Object::Handle();
  const GrowableObjectArray& declarations =
      GrowableObjectArray::Handle(GrowableObjectArray::New());
  {
    auto thread = Thread::Current();
    SafepointReadRwLocker ml(thread, thread->isolate_group()->program_lock());
    MetadataMap map(metadata());
    MetadataMap::Iterator it(&map);
    while (it.MoveNext()) {
      const intptr_t entry = it.Current();
      ASSERT(entry != -1);
      declaration = map.GetKey(entry);
      if (HasPragma(declaration)) {
        declarations.Add(declaration);
      }
    }
    set_metadata(map.Release());
  }
  for (intptr_t i = 0; i < declarations.Length(); ++i) {
    declaration = declarations.At(i);
    GetMetadata(declaration);
  }
}

◆ exports()

ArrayPtr dart::Library::exports ( ) const

inline

Definition at line 5188 of file object.h.

5188{ return untag()->exports(); }

◆ ffi_native_resolver()

Dart_FfiNativeResolver dart::Library::ffi_native_resolver ( ) const

inline

Definition at line 5221 of file object.h.

                                                     {
    return LoadNonPointer<Dart_FfiNativeResolver, std::memory_order_relaxed>(
        &untag()->ffi_native_resolver_);
  }

◆ FfiLibrary()

LibraryPtr dart::Library::FfiLibrary ( )

static

Definition at line 14846 of file object.cc.

                               {
  return IsolateGroup::Current()->object_store()->ffi_library();
}

◆ FinalizeAllClasses()

ErrorPtr dart::Library::FinalizeAllClasses ( )

static

Definition at line 15317 of file object.cc.

                                     {
  Thread* thread = Thread::Current();
  ASSERT(thread->IsDartMutatorThread());
  Zone* zone = thread->zone();
  Error& error = Error::Handle(zone);
  const GrowableObjectArray& libs = GrowableObjectArray::Handle(
      IsolateGroup::Current()->object_store()->libraries());
  Library& lib = Library::Handle(zone);
  Class& cls = Class::Handle(zone);
  for (int i = 0; i < libs.Length(); i++) {
    lib ^= libs.At(i);
    if (!lib.Loaded()) {
      String& uri = String::Handle(zone, lib.url());
      String& msg = String::Handle(
          zone,
          String::NewFormatted("Library '%s' is not loaded. "
                               "Did you forget to call Dart_FinalizeLoading?",
                               uri.ToCString()));
      return ApiError::New(msg);
    }
    ClassDictionaryIterator it(lib, ClassDictionaryIterator::kIteratePrivate);
    while (it.HasNext()) {
      cls = it.GetNextClass();
      error = cls.EnsureIsFinalized(thread);
      if (!error.IsNull()) {
        return error.ptr();
      }
    }
  }
  return Error::null();
}

◆ FindPragma()

bool dart::Library::FindPragma	(	Thread *	T,
		bool	only_core,
		const Object &	object,
		const String &	pragma_name,
		bool	multiple = `false`,
		Object *	options = `nullptr`
	)

static

Definition at line 4201 of file object.cc.

                                          {
  auto Z = T->zone();
  auto& lib = Library::Handle(Z);
 
  if (obj.IsLibrary()) {
    lib = Library::Cast(obj).ptr();
  } else if (obj.IsClass()) {
    auto& klass = Class::Cast(obj);
    if (!klass.has_pragma()) return false;
    lib = klass.library();
  } else if (obj.IsFunction()) {
    auto& function = Function::Cast(obj);
    if (!function.has_pragma()) return false;
    lib = Class::Handle(Z, function.Owner()).library();
  } else if (obj.IsField()) {
    auto& field = Field::Cast(obj);
    if (!field.has_pragma()) return false;
    lib = Class::Handle(Z, field.Owner()).library();
  } else {
    UNREACHABLE();
  }
 
  if (only_core && !lib.IsAnyCoreLibrary()) {
    return false;
  }
 
  Object& metadata_obj = Object::Handle(Z, lib.GetMetadata(obj));
  if (metadata_obj.IsUnwindError()) {
    Report::LongJump(UnwindError::Cast(metadata_obj));
  }
 
  return FindPragmaInMetadata(T, metadata_obj, pragma_name, multiple, options);
}

◆ GetFunction()

FunctionPtr dart::Library::GetFunction	(	const GrowableArray< Library * > &	libs,
		const char *	class_name,
		const char *	function_name
	)

static

Definition at line 15352 of file object.cc.

                                                            {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  Function& func = Function::Handle(zone);
  String& class_str = String::Handle(zone);
  String& func_str = String::Handle(zone);
  Class& cls = Class::Handle(zone);
  for (intptr_t l = 0; l < libs.length(); l++) {
    const Library& lib = *libs[l];
    if (strcmp(class_name, "::") == 0) {
      cls = lib.toplevel_class();
    } else {
      class_str = String::New(class_name);
      cls = lib.LookupClassAllowPrivate(class_str);
    }
    if (!cls.IsNull()) {
      if (cls.EnsureIsFinalized(thread) == Error::null()) {
        func_str = String::New(function_name);
        if (function_name[0] == '.') {
          func_str = String::Concat(class_str, func_str);
        }
        func = cls.LookupFunctionAllowPrivate(func_str);
      }
    }
    if (!func.IsNull()) {
      return func.ptr();
    }
  }
  return Function::null();
}

◆ GetFunctionClosure()

ObjectPtr dart::Library::GetFunctionClosure ( const String & name ) const

Definition at line 15385 of file object.cc.

                                                              {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  Function& func = Function::Handle(zone, LookupFunctionAllowPrivate(name));
  if (func.IsNull()) {
    // Check whether the function is reexported into the library.
    const Object& obj = Object::Handle(zone, LookupReExport(name));
    if (obj.IsFunction()) {
      func ^= obj.ptr();
    } else {
      // Check if there is a getter of 'name', in which case invoke it
      // and return the result.
      const String& getter_name = String::Handle(zone, Field::GetterName(name));
      func = LookupFunctionAllowPrivate(getter_name);
      if (func.IsNull()) {
        return Closure::null();
      }
      // Invoke the getter and return the result.
      return DartEntry::InvokeFunction(func, Object::empty_array());
    }
  }
  func = func.ImplicitClosureFunction();
  return func.ImplicitStaticClosure();
}

◆ GetLibrary()

LibraryPtr dart::Library::GetLibrary ( intptr_t index )

static

Definition at line 14763 of file object.cc.

                                             {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  auto isolate_group = thread->isolate_group();
  const GrowableObjectArray& libs = GrowableObjectArray::Handle(
      zone, isolate_group->object_store()->libraries());
  ASSERT(!libs.IsNull());
  if ((0 <= index) && (index < libs.Length())) {
    Library& lib = Library::Handle(zone);
    lib ^= libs.At(index);
    return lib.ptr();
  }
  return Library::null();
}

◆ GetMetadata()

ObjectPtr dart::Library::GetMetadata ( const Object & declaration ) const

Definition at line 13701 of file object.cc.

                                                              {
#if defined(DART_PRECOMPILED_RUNTIME)
  return Object::empty_array().ptr();
#else
  RELEASE_ASSERT(declaration.IsClass() || declaration.IsField() ||
                 declaration.IsFunction() || declaration.IsLibrary() ||
                 declaration.IsTypeParameter() || declaration.IsNamespace());
 
  auto thread = Thread::Current();
  auto zone = thread->zone();
 
  if (declaration.IsLibrary()) {
    // Ensure top-level class is loaded as it may contain annotations of
    // a library.
    const auto& cls = Class::Handle(zone, toplevel_class());
    if (!cls.IsNull()) {
      cls.EnsureDeclarationLoaded();
    }
  }
  Object& value = Object::Handle(zone);
  {
    SafepointReadRwLocker ml(thread, thread->isolate_group()->program_lock());
    MetadataMap map(metadata());
    value = map.GetOrNull(declaration);
    set_metadata(map.Release());
  }
  if (value.IsNull()) {
    // There is no metadata for this object.
    return Object::empty_array().ptr();
  }
  if (!value.IsSmi()) {
    // Metadata is already evaluated.
    ASSERT(value.IsArray());
    return value.ptr();
  }
  const auto& smi_value = Smi::Cast(value);
  intptr_t kernel_offset = smi_value.Value();
  ASSERT(kernel_offset > 0);
  const auto& evaluated_value = Object::Handle(
      zone, kernel::EvaluateMetadata(
                *this, kernel_offset,
                /* is_annotations_offset = */ declaration.IsLibrary() ||
                    declaration.IsNamespace()));
  if (evaluated_value.IsArray() || evaluated_value.IsNull()) {
    ASSERT(evaluated_value.ptr() != Object::empty_array().ptr());
    SafepointWriteRwLocker ml(thread, thread->isolate_group()->program_lock());
    MetadataMap map(metadata());
    if (map.GetOrNull(declaration) == smi_value.ptr()) {
      map.UpdateOrInsert(declaration, evaluated_value);
    } else {
      ASSERT(map.GetOrNull(declaration) == evaluated_value.ptr());
    }
    set_metadata(map.Release());
  }
  return evaluated_value.ptr();
#endif  // defined(DART_PRECOMPILED_RUNTIME)
}

◆ ImportAt()

NamespacePtr dart::Library::ImportAt ( intptr_t index ) const

Definition at line 14201 of file object.cc.

                                                   {
  if ((index < 0) || index >= num_imports()) {
    return Namespace::null();
  }
  const Array& import_list = Array::Handle(imports());
  return Namespace::RawCast(import_list.At(index));
}

◆ ImportLibraryAt()

LibraryPtr dart::Library::ImportLibraryAt ( intptr_t index ) const

Definition at line 14193 of file object.cc.

                                                        {
  Namespace& import = Namespace::Handle(ImportAt(index));
  if (import.IsNull()) {
    return Library::null();
  }
  return import.target();
}

◆ imports()

ArrayPtr dart::Library::imports ( ) const

inline

Definition at line 5187 of file object.h.

5187{ return untag()->imports(); }

◆ index()

intptr_t dart::Library::index ( ) const

inline

Definition at line 5241 of file object.h.

5241{ return untag()->index_; }

◆ InitCoreLibrary()

void dart::Library::InitCoreLibrary ( IsolateGroup * isolate_group )

static

Definition at line 14349 of file object.cc.

                                                         {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  const String& core_lib_url = Symbols::DartCore();
  const Library& core_lib =
      Library::Handle(zone, Library::NewLibraryHelper(core_lib_url, false));
  core_lib.SetLoadRequested();
  core_lib.Register(thread);
  isolate_group->object_store()->set_bootstrap_library(ObjectStore::kCore,
                                                       core_lib);
  isolate_group->object_store()->set_root_library(Library::Handle());
}

◆ InitNativeWrappersLibrary()

void dart::Library::InitNativeWrappersLibrary	(	IsolateGroup *	isolate_group,
		bool	is_kernel_file
	)

static

Definition at line 14590 of file object.cc.

                                                        {
  const int kNumNativeWrappersClasses = 4;
  COMPILE_ASSERT((kNumNativeWrappersClasses > 0) &&
                 (kNumNativeWrappersClasses < 10));
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  const String& native_flds_lib_url = Symbols::DartNativeWrappers();
  const Library& native_flds_lib = Library::Handle(
      zone, Library::NewLibraryHelper(native_flds_lib_url, false));
  const String& native_flds_lib_name = Symbols::DartNativeWrappersLibName();
  native_flds_lib.SetName(native_flds_lib_name);
  native_flds_lib.SetLoadRequested();
  native_flds_lib.Register(thread);
  native_flds_lib.SetLoadInProgress();
  isolate_group->object_store()->set_native_wrappers_library(native_flds_lib);
  const char* const kNativeWrappersClass = "NativeFieldWrapperClass";
  const int kNameLength = 25;
  ASSERT(kNameLength == (strlen(kNativeWrappersClass) + 1 + 1));
  char name_buffer[kNameLength];
  String& cls_name = String::Handle(zone);
  for (int fld_cnt = 1; fld_cnt <= kNumNativeWrappersClasses; fld_cnt++) {
    Utils::SNPrint(name_buffer, kNameLength, "%s%d", kNativeWrappersClass,
                   fld_cnt);
    cls_name = Symbols::New(thread, name_buffer);
    Class::NewNativeWrapper(native_flds_lib, cls_name, fld_cnt);
  }
  // NOTE: If we bootstrap from a Kernel IR file we want to generate the
  // synthetic constructors for the native wrapper classes.  We leave this up to
  // the [KernelLoader] who will take care of it later.
  if (!is_kernel) {
    native_flds_lib.SetLoaded();
  }
}

◆ InstanceSize()

static intptr_t dart::Library::InstanceSize ( )

inlinestatic

Definition at line 5090 of file object.h.

                                 {
    return RoundedAllocationSize(sizeof(UntaggedLibrary));
  }

◆ InternalLibrary()

LibraryPtr dart::Library::InternalLibrary ( )

static

Definition at line 14850 of file object.cc.

                                    {
  return IsolateGroup::Current()->object_store()->_internal_library();
}

◆ Invoke()

ObjectPtr dart::Library::Invoke	(	const String &	selector,
		const Array &	arguments,
		const Array &	argument_names,
		bool	respect_reflectable = `true`,
		bool	check_is_entrypoint = `false`
	)		const

Definition at line 14520 of file object.cc.

                                                          {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
 
  // We don't pass any explicit type arguments, which will be understood as
  // using dynamic for any function type arguments by lower layers.
  const int kTypeArgsLen = 0;
  const Array& args_descriptor_array = Array::Handle(
      zone, ArgumentsDescriptor::NewBoxed(kTypeArgsLen, args.Length(),
                                          arg_names, Heap::kNew));
  ArgumentsDescriptor args_descriptor(args_descriptor_array);
 
  auto& function = Function::Handle(zone);
  auto& result =
      Object::Handle(zone, LookupLocalOrReExportObject(function_name));
  if (result.IsFunction()) {
    function ^= result.ptr();
  }
 
  if (!function.IsNull() && check_is_entrypoint) {
    CHECK_ERROR(function.VerifyCallEntryPoint());
  }
 
  if (function.IsNull()) {
    // Didn't find a method: try to find a getter and invoke call on its result.
    const Object& getter_result = Object::Handle(
        zone, InvokeGetter(function_name, false, respect_reflectable,
                           check_is_entrypoint));
    if (getter_result.ptr() != Object::sentinel().ptr()) {
      if (check_is_entrypoint) {
        CHECK_ERROR(EntryPointFieldInvocationError(function_name));
      }
      const auto& call_args_descriptor_array = Array::Handle(
          zone, ArgumentsDescriptor::NewBoxed(args_descriptor.TypeArgsLen(),
                                              args_descriptor.Count() + 1,
                                              arg_names, Heap::kNew));
      const auto& call_args = Array::Handle(
          zone,
          CreateCallableArgumentsFromStatic(zone, Instance::Cast(getter_result),
                                            args, arg_names, args_descriptor));
      return DartEntry::InvokeClosure(thread, call_args,
                                      call_args_descriptor_array);
    }
  }
 
  if (function.IsNull() ||
      (respect_reflectable && !function.is_reflectable())) {
    return ThrowNoSuchMethod(Object::null_string(), function_name, args,
                             arg_names, InvocationMirror::kTopLevel,
                             InvocationMirror::kMethod);
  }
  if (!function.AreValidArguments(args_descriptor, nullptr)) {
    return ThrowNoSuchMethod(
        String::Handle(function.UserVisibleSignature()), function_name, args,
        arg_names, InvocationMirror::kTopLevel, InvocationMirror::kMethod);
  }
  // This is a static function, so we pass an empty instantiator tav.
  ASSERT(function.is_static());
  ObjectPtr type_error = function.DoArgumentTypesMatch(
      args, args_descriptor, Object::empty_type_arguments());
  if (type_error != Error::null()) {
    return type_error;
  }
  return DartEntry::InvokeFunction(function, args, args_descriptor_array);
}

◆ InvokeGetter()

ObjectPtr dart::Library::InvokeGetter	(	const String &	selector,
		bool	throw_nsm_if_absent,
		bool	respect_reflectable = `true`,
		bool	check_is_entrypoint = `false`
	)		const

Definition at line 14389 of file object.cc.

                                                                {
  Object& obj = Object::Handle(LookupLocalOrReExportObject(getter_name));
  Function& getter = Function::Handle();
  if (obj.IsField()) {
    const Field& field = Field::Cast(obj);
    if (check_is_entrypoint) {
      CHECK_ERROR(field.VerifyEntryPoint(EntryPointPragma::kGetterOnly));
    }
    if (!field.IsUninitialized()) {
      return field.StaticValue();
    }
    // An uninitialized field was found.  Check for a getter in the field's
    // owner class.
    const Class& klass = Class::Handle(field.Owner());
    const String& internal_getter_name =
        String::Handle(Field::GetterName(getter_name));
    getter = klass.LookupStaticFunction(internal_getter_name);
  } else {
    // No field found. Check for a getter in the lib.
    const String& internal_getter_name =
        String::Handle(Field::GetterName(getter_name));
    obj = LookupLocalOrReExportObject(internal_getter_name);
    if (obj.IsFunction()) {
      getter = Function::Cast(obj).ptr();
      if (check_is_entrypoint) {
        CHECK_ERROR(getter.VerifyCallEntryPoint());
      }
    } else {
      obj = LookupLocalOrReExportObject(getter_name);
      // Normally static top-level methods cannot be closurized through the
      // native API even if they are marked as entry-points, with the one
      // exception of "main".
      if (obj.IsFunction() && check_is_entrypoint) {
        if (!getter_name.Equals(String::Handle(String::New("main"))) ||
            ptr() != IsolateGroup::Current()->object_store()->root_library()) {
          CHECK_ERROR(Function::Cast(obj).VerifyClosurizedEntryPoint());
        }
      }
      if (obj.IsFunction() && Function::Cast(obj).SafeToClosurize()) {
        // Looking for a getter but found a regular method: closurize it.
        const Function& closure_function =
            Function::Handle(Function::Cast(obj).ImplicitClosureFunction());
        return closure_function.ImplicitStaticClosure();
      }
    }
  }
 
  if (getter.IsNull() || (respect_reflectable && !getter.is_reflectable())) {
    if (throw_nsm_if_absent) {
      return ThrowNoSuchMethod(Object::null_string(), getter_name,
                               Object::null_array(), Object::null_array(),
                               InvocationMirror::kTopLevel,
                               InvocationMirror::kGetter);
    }
 
    // Fall through case: Indicate that we didn't find any function or field
    // using a special null instance. This is different from a field being null.
    // Callers make sure that this null does not leak into Dartland.
    return Object::sentinel().ptr();
  }
 
  // Invoke the getter and return the result.
  return DartEntry::InvokeFunction(getter, Object::empty_array());
}

◆ InvokeSetter()

ObjectPtr dart::Library::InvokeSetter	(	const String &	selector,
		const Instance &	argument,
		bool	respect_reflectable = `true`,
		bool	check_is_entrypoint = `false`
	)		const

Definition at line 14457 of file object.cc.

                                                                {
  Object& obj = Object::Handle(LookupLocalOrReExportObject(setter_name));
  const String& internal_setter_name =
      String::Handle(Field::SetterName(setter_name));
  AbstractType& setter_type = AbstractType::Handle();
  AbstractType& argument_type = AbstractType::Handle(value.GetType(Heap::kOld));
  if (obj.IsField()) {
    const Field& field = Field::Cast(obj);
    if (check_is_entrypoint) {
      CHECK_ERROR(field.VerifyEntryPoint(EntryPointPragma::kSetterOnly));
    }
    setter_type = field.type();
    if (!argument_type.IsNullType() && !setter_type.IsDynamicType() &&
        !value.IsInstanceOf(setter_type, Object::null_type_arguments(),
                            Object::null_type_arguments())) {
      return ThrowTypeError(field.token_pos(), value, setter_type, setter_name);
    }
    if (field.is_final() || (respect_reflectable && !field.is_reflectable())) {
      const int kNumArgs = 1;
      const Array& args = Array::Handle(Array::New(kNumArgs));
      args.SetAt(0, value);
 
      return ThrowNoSuchMethod(Object::null_string(), internal_setter_name,
                               args, Object::null_array(),
                               InvocationMirror::kTopLevel,
                               InvocationMirror::kSetter);
    }
    field.SetStaticValue(value);
    return value.ptr();
  }
 
  Function& setter = Function::Handle();
  obj = LookupLocalOrReExportObject(internal_setter_name);
  if (obj.IsFunction()) {
    setter ^= obj.ptr();
  }
 
  if (!setter.IsNull() && check_is_entrypoint) {
    CHECK_ERROR(setter.VerifyCallEntryPoint());
  }
 
  const int kNumArgs = 1;
  const Array& args = Array::Handle(Array::New(kNumArgs));
  args.SetAt(0, value);
  if (setter.IsNull() || (respect_reflectable && !setter.is_reflectable())) {
    return ThrowNoSuchMethod(Object::null_string(), internal_setter_name, args,
                             Object::null_array(), InvocationMirror::kTopLevel,
                             InvocationMirror::kSetter);
  }
 
  setter_type = setter.ParameterTypeAt(0);
  if (!argument_type.IsNullType() && !setter_type.IsDynamicType() &&
      !value.IsInstanceOf(setter_type, Object::null_type_arguments(),
                          Object::null_type_arguments())) {
    return ThrowTypeError(setter.token_pos(), value, setter_type, setter_name);
  }
 
  return DartEntry::InvokeFunction(setter, args);
}

◆ is_dart_scheme()

bool dart::Library::is_dart_scheme ( ) const

inline

Definition at line 5259 of file object.h.

                              {
    return UntaggedLibrary::DartSchemeBit::decode(untag()->flags_);
  }

◆ is_in_fullsnapshot()

bool dart::Library::is_in_fullsnapshot ( ) const

inline

Definition at line 5231 of file object.h.

                                  {
    return UntaggedLibrary::InFullSnapshotBit::decode(untag()->flags_);
  }

◆ IsAnyCoreLibrary()

bool dart::Library::IsAnyCoreLibrary ( ) const

Definition at line 13616 of file object.cc.

                                     {
  String& url_str = Thread::Current()->StringHandle();
  url_str = url();
  return url_str.StartsWith(Symbols::DartScheme()) ||
         url_str.StartsWith(Symbols::DartSchemePrivate());
}

◆ IsDebuggable()

bool dart::Library::IsDebuggable ( ) const

inline

Definition at line 5252 of file object.h.

                            {
    return UntaggedLibrary::DebuggableBit::decode(untag()->flags_);
  }

◆ IsolateLibrary()

LibraryPtr dart::Library::IsolateLibrary ( )

static

Definition at line 14854 of file object.cc.

                                   {
  return IsolateGroup::Current()->object_store()->isolate_library();
}

◆ IsPrivate()

bool dart::Library::IsPrivate ( const String & name )

static

Definition at line 14666 of file object.cc.

                                          {
  if (ShouldBePrivate(name)) return true;
  // Factory names: List._fromLiteral.
  for (intptr_t i = 1; i < name.Length() - 1; i++) {
    if (name.CharAt(i) == '.') {
      if (name.CharAt(i + 1) == '_') {
        return true;
      }
    }
  }
  return false;
}

◆ IsPrivateCoreLibName()

bool dart::Library::IsPrivateCoreLibName	(	const String &	name,
		const String &	member
	)

static

Definition at line 14727 of file object.cc.

                                                                           {
  Zone* zone = Thread::Current()->zone();
  const auto& core_lib = Library::Handle(zone, Library::CoreLibrary());
  const auto& private_key = String::Handle(zone, core_lib.private_key());
 
  ASSERT(core_lib.IsPrivate(member));
  return name.EqualsConcat(member, private_key);
}

◆ kernel_library_index()

intptr_t dart::Library::kernel_library_index ( ) const

inline

Definition at line 5280 of file object.h.

                                        {
#if defined(DART_PRECOMPILED_RUNTIME)
    return 0;
#else
    return untag()->kernel_library_index_;
#endif
  }

◆ kernel_program_info()

KernelProgramInfoPtr dart::Library::kernel_program_info ( ) const

inline

Definition at line 5272 of file object.h.

                                                   {
    return untag()->kernel_program_info();
  }

◆ KernelLibrary()

TypedDataViewPtr dart::Library::KernelLibrary ( ) const

Definition at line 13648 of file object.cc.

                                              {
  const auto& info = KernelProgramInfo::Handle(kernel_program_info());
  return info.KernelLibrary(kernel_library_index());
}

◆ KernelLibraryOffset()

intptr_t dart::Library::KernelLibraryOffset ( ) const

Definition at line 13653 of file object.cc.

                                            {
  const auto& info = KernelProgramInfo::Handle(kernel_program_info());
  return info.KernelLibraryStartOffset(kernel_library_index());
}

◆ Loaded()

bool dart::Library::Loaded ( ) const

inline

Definition at line 5082 of file object.h.

                      {
    return untag()->load_state_ == UntaggedLibrary::kLoaded;
  }

◆ LoadedScripts()

ArrayPtr dart::Library::LoadedScripts ( ) const

Definition at line 13987 of file object.cc.

                                      {
  // We compute the list of loaded scripts lazily. The result is
  // cached in loaded_scripts_.
  if (loaded_scripts() == Array::null()) {
    // TODO(jensj): This can be cleaned up.
    // It really should just return the content of `used_scripts`, and there
    // should be no need to do the O(n) call to `AddScriptIfUnique` per script.
 
    // Iterate over the library dictionary and collect all scripts.
    const GrowableObjectArray& scripts =
        GrowableObjectArray::Handle(GrowableObjectArray::New(8));
    Object& entry = Object::Handle();
    Class& cls = Class::Handle();
    Script& owner_script = Script::Handle();
    DictionaryIterator it(*this);
    while (it.HasNext()) {
      entry = it.GetNext();
      if (entry.IsClass()) {
        owner_script = Class::Cast(entry).script();
      } else if (entry.IsFunction()) {
        owner_script = Function::Cast(entry).script();
      } else if (entry.IsField()) {
        owner_script = Field::Cast(entry).Script();
      } else {
        continue;
      }
      AddScriptIfUnique(scripts, owner_script);
    }
 
    // Add all scripts from patch classes.
    GrowableObjectArray& patches = GrowableObjectArray::Handle(used_scripts());
    for (intptr_t i = 0; i < patches.Length(); i++) {
      entry = patches.At(i);
      if (entry.IsClass()) {
        owner_script = Class::Cast(entry).script();
      } else {
        ASSERT(entry.IsScript());
        owner_script = Script::Cast(entry).ptr();
      }
      AddScriptIfUnique(scripts, owner_script);
    }
 
    cls = toplevel_class();
    if (!cls.IsNull()) {
      owner_script = cls.script();
      AddScriptIfUnique(scripts, owner_script);
      // Special case: Scripts that only contain external top-level functions
      // are not included above, but can be referenced through a library's
      // anonymous classes. Example: dart-core:identical.dart.
      Function& func = Function::Handle();
      Array& functions = Array::Handle(cls.current_functions());
      for (intptr_t j = 0; j < functions.Length(); j++) {
        func ^= functions.At(j);
        if (func.is_external()) {
          owner_script = func.script();
          AddScriptIfUnique(scripts, owner_script);
        }
      }
    }
 
    // Create the array of scripts and cache it in loaded_scripts_.
    const Array& scripts_array = Array::Handle(Array::MakeFixedLength(scripts));
    untag()->set_loaded_scripts(scripts_array.ptr());
  }
  return loaded_scripts();
}

◆ loading_unit()

LoadingUnitPtr dart::Library::loading_unit ( ) const

inline

Definition at line 5087 of file object.h.

5087{ return untag()->loading_unit(); }

◆ LoadInProgress()

bool dart::Library::LoadInProgress ( ) const

inline

Definition at line 5077 of file object.h.

                              {
    return untag()->load_state_ == UntaggedLibrary::kLoadInProgress;
  }

◆ LoadNotStarted()

bool dart::Library::LoadNotStarted ( ) const

inline

Definition at line 5071 of file object.h.

                              {
    return untag()->load_state_ == UntaggedLibrary::kAllocated;
  }

◆ LoadRequested()

bool dart::Library::LoadRequested ( ) const

inline

Definition at line 5074 of file object.h.

                             {
    return untag()->load_state_ == UntaggedLibrary::kLoadRequested;
  }

◆ LookupClass()

ClassPtr dart::Library::LookupClass ( const String & name ) const

Definition at line 14152 of file object.cc.

                                                      {
  Object& obj = Object::Handle(LookupLocalObject(name));
  if (obj.IsClass()) {
    return Class::Cast(obj).ptr();
  }
  return Class::null();
}

◆ LookupClassAllowPrivate()

ClassPtr dart::Library::LookupClassAllowPrivate ( const String & name ) const

Definition at line 14160 of file object.cc.

                                                                  {
  Object& obj = Object::Handle(LookupLocalObjectAllowPrivate(name));
  if (obj.IsClass()) {
    return Class::Cast(obj).ptr();
  }
  return Class::null();
}

◆ LookupCoreClass()

ClassPtr dart::Library::LookupCoreClass ( const String & class_name )

static

Definition at line 14736 of file object.cc.

                                                          {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  const Library& core_lib = Library::Handle(zone, Library::CoreLibrary());
  String& name = String::Handle(zone, class_name.ptr());
  if (class_name.CharAt(0) == kPrivateIdentifierStart) {
    // Private identifiers are mangled on a per library basis.
    name = Symbols::FromConcat(thread, name,
                               String::Handle(zone, core_lib.private_key()));
  }
  return core_lib.LookupClass(name);
}

◆ LookupFieldAllowPrivate()

FieldPtr dart::Library::LookupFieldAllowPrivate ( const String & name ) const

Definition at line 14122 of file object.cc.

                                                                  {
  EnsureTopLevelClassIsFinalized();
  Object& obj = Object::Handle(LookupLocalObjectAllowPrivate(name));
  if (obj.IsField()) {
    return Field::Cast(obj).ptr();
  }
  return Field::null();
}

◆ LookupFunctionAllowPrivate()

FunctionPtr dart::Library::LookupFunctionAllowPrivate ( const String & name ) const

Definition at line 14131 of file object.cc.

                                                                        {
  EnsureTopLevelClassIsFinalized();
  Object& obj = Object::Handle(LookupLocalObjectAllowPrivate(name));
  if (obj.IsFunction()) {
    return Function::Cast(obj).ptr();
  }
  return Function::null();
}

◆ LookupLibrary()

LibraryPtr dart::Library::LookupLibrary	(	Thread *	thread,
		const String &	url
	)

static

Definition at line 14646 of file object.cc.

                                                                   {
  Zone* zone = thread->zone();
  ObjectStore* object_store = thread->isolate_group()->object_store();
 
  // Make sure the URL string has an associated hash code
  // to speed up the repeated equality checks.
  url.Hash();
 
  // Use the libraries map to lookup the library by URL.
  Library& lib = Library::Handle(zone);
  if (object_store->libraries_map() == Array::null()) {
    return Library::null();
  } else {
    LibraryLookupMap map(object_store->libraries_map());
    lib ^= map.GetOrNull(url);
    ASSERT(map.Release().ptr() == object_store->libraries_map());
  }
  return lib.ptr();
}

◆ LookupLocalLibraryPrefix()

LibraryPrefixPtr dart::Library::LookupLocalLibraryPrefix ( const String & name ) const

Definition at line 14168 of file object.cc.

                                                                           {
  const Object& obj = Object::Handle(LookupLocalObject(name));
  if (obj.IsLibraryPrefix()) {
    return LibraryPrefix::Cast(obj).ptr();
  }
  return LibraryPrefix::null();
}

◆ LookupLocalOrReExportObject()

ObjectPtr dart::Library::LookupLocalOrReExportObject ( const String & name ) const

Definition at line 14112 of file object.cc.

                                                                       {
  intptr_t index;
  EnsureTopLevelClassIsFinalized();
  const Object& result = Object::Handle(LookupEntry(name, &index));
  if (!result.IsNull() && !result.IsLibraryPrefix()) {
    return result.ptr();
  }
  return LookupReExport(name);
}

◆ LookupReExport()

ObjectPtr dart::Library::LookupReExport	(	const String &	name,
		ZoneGrowableArray< intptr_t > *	visited = `nullptr`
	)		const

Definition at line 13902 of file object.cc.

                                                                            {
  if (!HasExports()) {
    return Object::null();
  }
 
  if (trail == nullptr) {
    trail = new ZoneGrowableArray<intptr_t>();
  }
  Object& obj = Object::Handle();
 
  const intptr_t lib_id = this->index();
  ASSERT(lib_id >= 0);  // We use -1 to indicate that a cycle was found.
  trail->Add(lib_id);
  const Array& exports = Array::Handle(this->exports());
  Namespace& ns = Namespace::Handle();
  for (int i = 0; i < exports.Length(); i++) {
    ns ^= exports.At(i);
    obj = ns.Lookup(name, trail);
    if (!obj.IsNull()) {
      // The Lookup call above may return a setter x= when we are looking
      // for the name x. Make sure we only return when a matching name
      // is found.
      String& obj_name = String::Handle(obj.DictionaryName());
      if (Field::IsSetterName(obj_name) == Field::IsSetterName(name)) {
        break;
      }
    }
  }
  trail->RemoveLast();
  return obj.ptr();
}

◆ LookupScript()

ScriptPtr dart::Library::LookupScript	(	const String &	url,
		bool	useResolvedUri = `false`
	)		const

Definition at line 14056 of file object.cc.

                                                             {
  const intptr_t url_length = url.Length();
  if (url_length == 0) {
    return Script::null();
  }
  const Array& scripts = Array::Handle(LoadedScripts());
  Script& script = Script::Handle();
  String& script_url = String::Handle();
  const intptr_t num_scripts = scripts.Length();
  for (int i = 0; i < num_scripts; i++) {
    script ^= scripts.At(i);
    if (useResolvedUri) {
      // Use for urls with 'org-dartlang-sdk:' or 'file:' schemes
      script_url = script.resolved_url();
    } else {
      // Use for urls with 'dart:', 'package:', or 'file:' schemes
      script_url = script.url();
    }
    const intptr_t start_idx = script_url.Length() - url_length;
    if ((start_idx == 0) && url.Equals(script_url)) {
      return script.ptr();
    } else if (start_idx > 0) {
      // If we do a suffix match, only match if the partial path
      // starts at or immediately after the path separator.
      if (((url.CharAt(0) == '/') ||
           (script_url.CharAt(start_idx - 1) == '/')) &&
          url.Equals(script_url, start_idx, url_length)) {
        return script.ptr();
      }
    }
  }
  return Script::null();
}

◆ MathLibrary()

LibraryPtr dart::Library::MathLibrary ( )

static

Definition at line 14858 of file object.cc.

                                {
  return IsolateGroup::Current()->object_store()->math_library();
}

◆ MirrorsLibrary()

LibraryPtr dart::Library::MirrorsLibrary ( )

static

Definition at line 14863 of file object.cc.

                                   {
  return IsolateGroup::Current()->object_store()->mirrors_library();
}

◆ name()

StringPtr dart::Library::name ( ) const

inline

Definition at line 5065 of file object.h.

5065{ return untag()->name(); }

◆ native_entry_resolver()

Dart_NativeEntryResolver dart::Library::native_entry_resolver ( ) const

inline

Definition at line 5200 of file object.h.

                                                         {
    return LoadNonPointer<Dart_NativeEntryResolver, std::memory_order_relaxed>(
        &untag()->native_entry_resolver_);
  }

◆ native_entry_symbol_resolver()

Dart_NativeEntrySymbol dart::Library::native_entry_symbol_resolver ( ) const

inline

Definition at line 5209 of file object.h.

                                                              {
    return LoadNonPointer<Dart_NativeEntrySymbol, std::memory_order_relaxed>(
        &untag()->native_entry_symbol_resolver_);
  }

◆ NativeWrappersLibrary()

LibraryPtr dart::Library::NativeWrappersLibrary ( )

static

Definition at line 14868 of file object.cc.

                                          {
  return IsolateGroup::Current()->object_store()->native_wrappers_library();
}

◆ New()

LibraryPtr dart::Library::New ( const String & url )

static

Definition at line 14341 of file object.cc.

                                         {
  return NewLibraryHelper(url, false);
}

◆ num_imports()

intptr_t dart::Library::num_imports ( ) const

inline

Definition at line 5190 of file object.h.

5190{ return untag()->num_imports_; }

◆ private_key()

StringPtr dart::Library::private_key ( ) const

inline

Definition at line 5070 of file object.h.

5070{ return untag()->private_key(); }

◆ PrivateCoreLibName()

const String & dart::Library::PrivateCoreLibName ( const String & member )

static

Definition at line 14721 of file object.cc.

                                                              {
  const Library& core_lib = Library::Handle(Library::CoreLibrary());
  const String& private_name = String::ZoneHandle(core_lib.PrivateName(member));
  return private_name;
}

◆ PrivateName()

StringPtr dart::Library::PrivateName ( const String & name ) const

Definition at line 14751 of file object.cc.

                                                       {
  Thread* thread = Thread::Current();
  Zone* zone = thread->zone();
  ASSERT(IsPrivate(name));
  // ASSERT(strchr(name, '@') == nullptr);
  String& str = String::Handle(zone);
  str = name.ptr();
  str = Symbols::FromConcat(thread, str,
                            String::Handle(zone, this->private_key()));
  return str.ptr();
}

◆ Register()

void dart::Library::Register ( Thread * thread ) const

Definition at line 14778 of file object.cc.

                                           {
  Zone* zone = thread->zone();
  auto isolate_group = thread->isolate_group();
  ObjectStore* object_store = isolate_group->object_store();
 
  // A library is "registered" in two places:
  // - A growable array mapping from index to library.
  const String& lib_url = String::Handle(zone, url());
  ASSERT(Library::LookupLibrary(thread, lib_url) == Library::null());
  ASSERT(lib_url.HasHash());
  GrowableObjectArray& libs =
      GrowableObjectArray::Handle(zone, object_store->libraries());
  ASSERT(!libs.IsNull());
  set_index(libs.Length());
  libs.Add(*this);
 
  // - A map from URL string to library.
  if (object_store->libraries_map() == Array::null()) {
    LibraryLookupMap map(HashTables::New<LibraryLookupMap>(16, Heap::kOld));
    object_store->set_libraries_map(map.Release());
  }
 
  LibraryLookupMap map(object_store->libraries_map());
  bool present = map.UpdateOrInsert(lib_url, *this);
  ASSERT(!present);
  object_store->set_libraries_map(map.Release());
}

◆ RegisterLibraries()

void dart::Library::RegisterLibraries	(	Thread *	thread,
		const GrowableObjectArray &	libs
	)

static

Definition at line 14806 of file object.cc.

                                                                 {
  Zone* zone = thread->zone();
  auto isolate_group = thread->isolate_group();
  Library& lib = Library::Handle(zone);
  String& lib_url = String::Handle(zone);
 
  LibraryLookupMap map(HashTables::New<LibraryLookupMap>(16, Heap::kOld));
 
  intptr_t len = libs.Length();
  for (intptr_t i = 0; i < len; i++) {
    lib ^= libs.At(i);
    lib_url = lib.url();
    map.InsertNewOrGetValue(lib_url, lib);
  }
  // Now remember these in the isolate's object store.
  isolate_group->object_store()->set_libraries(libs);
  isolate_group->object_store()->set_libraries_map(map.Release());
}

◆ set_debuggable()

void dart::Library::set_debuggable ( bool value ) const

inline

Definition at line 5255 of file object.h.

                                        {
    set_flags(UntaggedLibrary::DebuggableBit::update(value, untag()->flags_));
  }

◆ set_dependencies()

void dart::Library::set_dependencies ( const Array & deps ) const

Definition at line 14181 of file object.cc.

                                                      {
  untag()->set_dependencies(deps.ptr());
}

◆ set_ffi_native_resolver()

void dart::Library::set_ffi_native_resolver ( Dart_FfiNativeResolver value ) const

inline

Definition at line 5225 of file object.h.

                                                                   {
    StoreNonPointer<Dart_FfiNativeResolver, Dart_FfiNativeResolver,
                    std::memory_order_relaxed>(&untag()->ffi_native_resolver_,
                                               value);
  }

◆ set_index()

void dart::Library::set_index ( intptr_t value ) const

inline

Definition at line 5242 of file object.h.

                                       {
    ASSERT((value == -1) ||
           ((value >= 0) && (value < std::numeric_limits<classid_t>::max())));
    StoreNonPointer(&untag()->index_, value);
  }

◆ set_is_dart_scheme()

void dart::Library::set_is_dart_scheme ( bool value ) const

inline

Definition at line 5262 of file object.h.

                                            {
    set_flags(UntaggedLibrary::DartSchemeBit::update(value, untag()->flags_));
  }

◆ set_is_in_fullsnapshot()

void dart::Library::set_is_in_fullsnapshot ( bool value ) const

inline

Definition at line 5234 of file object.h.

                                                {
    set_flags(
        UntaggedLibrary::InFullSnapshotBit::update(value, untag()->flags_));
  }

◆ set_kernel_library_index()

void dart::Library::set_kernel_library_index ( intptr_t value ) const

inline

Definition at line 5288 of file object.h.

                                                      {
#if defined(DART_PRECOMPILED_RUNTIME)
    UNREACHABLE();
#else
    ASSERT(value >= 0);
    StoreNonPointer(&untag()->kernel_library_index_, value);
#endif
  }

◆ set_kernel_program_info()

void dart::Library::set_kernel_program_info ( const KernelProgramInfo & info ) const

Definition at line 13644 of file object.cc.

                                                                         {
  untag()->set_kernel_program_info(info.ptr());
}

◆ set_loading_unit()

void dart::Library::set_loading_unit ( const LoadingUnit & value ) const

Definition at line 13659 of file object.cc.

                                                             {
  untag()->set_loading_unit(value.ptr());
}

◆ set_native_entry_resolver()

void dart::Library::set_native_entry_resolver ( Dart_NativeEntryResolver value ) const

inline

Definition at line 5204 of file object.h.

                                                                       {
    StoreNonPointer<Dart_NativeEntryResolver, Dart_NativeEntryResolver,
                    std::memory_order_relaxed>(&untag()->native_entry_resolver_,
                                               value);
  }

◆ set_native_entry_symbol_resolver()

void dart::Library::set_native_entry_symbol_resolver ( Dart_NativeEntrySymbol native_symbol_resolver ) const

inline

Definition at line 5213 of file object.h.

                                                           {
    StoreNonPointer<Dart_NativeEntrySymbol, Dart_NativeEntrySymbol,
                    std::memory_order_relaxed>(
        &untag()->native_entry_symbol_resolver_, native_symbol_resolver);
  }

◆ set_toplevel_class()

void dart::Library::set_toplevel_class ( const Class & value ) const

Definition at line 14176 of file object.cc.

                                                         {
  ASSERT(untag()->toplevel_class() == Class::null());
  untag()->set_toplevel_class(value.ptr());
}

◆ SetLoaded()

void dart::Library::SetLoaded ( ) const

Definition at line 13681 of file object.cc.

                              {
  // Should not be already loaded or just allocated.
  ASSERT(LoadInProgress() || LoadRequested());
  StoreNonPointer(&untag()->load_state_, UntaggedLibrary::kLoaded);
}

◆ SetLoadInProgress()

void dart::Library::SetLoadInProgress ( ) const

Definition at line 13669 of file object.cc.

                                      {
  // Must not already be in the process of being loaded.
  ASSERT(untag()->load_state_ <= UntaggedLibrary::kLoadRequested);
  StoreNonPointer(&untag()->load_state_, UntaggedLibrary::kLoadInProgress);
}

◆ SetLoadRequested()

void dart::Library::SetLoadRequested ( ) const

Definition at line 13675 of file object.cc.

                                     {
  // Must not be already loaded.
  ASSERT(untag()->load_state_ == UntaggedLibrary::kAllocated);
  StoreNonPointer(&untag()->load_state_, UntaggedLibrary::kLoadRequested);
}

◆ SetName()

void dart::Library::SetName ( const String & name ) const

Definition at line 13663 of file object.cc.

                                              {
  // Only set name once.
  ASSERT(!Loaded());
  set_name(name);
}

◆ toplevel_class()

ClassPtr dart::Library::toplevel_class ( ) const

inline

Definition at line 5179 of file object.h.

5179{ return untag()->toplevel_class(); }

◆ TypedDataLibrary()

LibraryPtr dart::Library::TypedDataLibrary ( )

static

Definition at line 14872 of file object.cc.

                                     {
  return IsolateGroup::Current()->object_store()->typed_data_library();
}

◆ url()

StringPtr dart::Library::url ( ) const

inline

Definition at line 5068 of file object.h.

5068{ return untag()->url(); }

◆ UrlHash()

intptr_t dart::Library::UrlHash ( ) const

inline

Definition at line 13327 of file object.h.

                                {
  intptr_t result = String::GetCachedHash(url());
  ASSERT(result != 0);
  return result;
}

◆ UrlOf()

static StringPtr dart::Library::UrlOf ( LibraryPtr lib )

inlinestatic

Definition at line 5069 of file object.h.

5069{ return lib->untag()->url(); }

◆ used_scripts()

GrowableObjectArrayPtr dart::Library::used_scripts ( ) const

inline

Definition at line 5182 of file object.h.

                                              {
    return untag()->used_scripts();
  }

◆ VMServiceLibrary()

LibraryPtr dart::Library::VMServiceLibrary ( )

static

Definition at line 14876 of file object.cc.

                                     {
  return IsolateGroup::Current()->object_store()->_vmservice_library();
}

Friends And Related Symbol Documentation

◆ Bootstrap

friend class Bootstrap

friend

Definition at line 5404 of file object.h.

◆ Class

friend class Class

friend

Definition at line 5405 of file object.h.

◆ Debugger

friend class Debugger

friend

Definition at line 5406 of file object.h.

◆ DictionaryIterator

friend class DictionaryIterator

friend

Definition at line 5407 of file object.h.

◆ Isolate

friend class Isolate

friend

Definition at line 5408 of file object.h.

◆ LibraryDeserializationCluster

friend class LibraryDeserializationCluster

friend

Definition at line 5409 of file object.h.

◆ Namespace

friend class Namespace

friend

Definition at line 5410 of file object.h.

◆ Object

friend class Object

friend

Definition at line 5411 of file object.h.

◆ Precompiler

friend class Precompiler

friend

Definition at line 5412 of file object.h.

Member Data Documentation

◆ kPrivateIdentifierStart

const char dart::Library::kPrivateIdentifierStart = '_'

static

Definition at line 5351 of file object.h.

◆ kPrivateKeySeparator

const char dart::Library::kPrivateKeySeparator = '@'

static

Definition at line 5355 of file object.h.

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

third_party/dart-lang/sdk/runtime/vm/object.h
third_party/dart-lang/sdk/runtime/vm/object.cc
third_party/dart-lang/sdk/runtime/vm/object_reload.cc

Public Member Functions

Static Public Member Functions

Static Public Attributes

Friends

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ AddClass()

◆ AddExport()

◆ AddImport()

◆ AddMetadata()

◆ AddObject()

◆ AsyncLibrary()

◆ CheckReload()

◆ CollectionLibrary()

◆ CompileAll()

◆ ConvertLibrary()

◆ CopyPragmas()

◆ CoreLibrary()

◆ dependencies()

◆ DeveloperLibrary()

◆ DropDependenciesAndCaches()

◆ EnsureTopLevelClassIsFinalized()

◆ EvaluateCompiledExpression()

◆ EvaluatePragmas()

◆ exports()

◆ ffi_native_resolver()

◆ FfiLibrary()

◆ FinalizeAllClasses()

◆ FindPragma()

◆ GetFunction()

◆ GetFunctionClosure()

◆ GetLibrary()

◆ GetMetadata()

◆ ImportAt()

◆ ImportLibraryAt()

◆ imports()

◆ index()

◆ InitCoreLibrary()

◆ InitNativeWrappersLibrary()

◆ InstanceSize()

◆ InternalLibrary()

◆ Invoke()

◆ InvokeGetter()

◆ InvokeSetter()

◆ is_dart_scheme()

◆ is_in_fullsnapshot()

◆ IsAnyCoreLibrary()

◆ IsDebuggable()

◆ IsolateLibrary()

◆ IsPrivate()

◆ IsPrivateCoreLibName()

◆ kernel_library_index()

◆ kernel_program_info()

◆ KernelLibrary()

◆ KernelLibraryOffset()

◆ Loaded()

◆ LoadedScripts()

◆ loading_unit()

◆ LoadInProgress()

◆ LoadNotStarted()

◆ LoadRequested()

◆ LookupClass()

◆ LookupClassAllowPrivate()

◆ LookupCoreClass()

◆ LookupFieldAllowPrivate()

◆ LookupFunctionAllowPrivate()

◆ LookupLibrary()

◆ LookupLocalLibraryPrefix()

◆ LookupLocalOrReExportObject()

◆ LookupReExport()

◆ LookupScript()

◆ MathLibrary()

◆ MirrorsLibrary()

◆ name()

◆ native_entry_resolver()

◆ native_entry_symbol_resolver()

◆ NativeWrappersLibrary()

◆ New()

◆ num_imports()