dart::bin::CObject Class Reference

#include <dartutils.h>

Inheritance diagram for dart::bin::CObject:

Public Member Functions
	CObject (Dart_CObject *cobject)
Dart_CObject_Type	type ()
Dart_TypedData_Type	byte_array_type ()
bool	IsNull ()
bool	IsBool ()
bool	IsInt32 ()
bool	IsInt64 ()
bool	IsInt32OrInt64 ()
bool	IsIntptr ()
bool	IsDouble ()
bool	IsString ()
bool	IsArray ()
bool	IsTypedData ()
bool	IsUint8Array ()
bool	IsSendPort ()
bool	IsTrue ()
bool	IsFalse ()
void *	operator new (size_t size)
Dart_CObject *	AsApiCObject ()

Static Public Member Functions
static CObject *	Null ()
static CObject *	True ()
static CObject *	False ()
static CObject *	Bool (bool value)
static Dart_CObject *	NewInt32 (int32_t value)
static Dart_CObject *	NewInt64 (int64_t value)
static Dart_CObject *	NewIntptr (intptr_t value)
static Dart_CObject *	NewDouble (double value)
static Dart_CObject *	NewString (const char *str)
static Dart_CObject *	NewArray (intptr_t length)
static Dart_CObject *	NewUint8Array (const void *data, intptr_t length)
static Dart_CObject *	NewExternalUint8Array (intptr_t length, uint8_t *data, void *peer, Dart_HandleFinalizer callback)
static Dart_CObject *	NewNativePointer (intptr_t ptr, intptr_t size, Dart_HandleFinalizer callback)
static Dart_CObject *	NewIOBuffer (int64_t length)
static void	ShrinkIOBuffer (Dart_CObject *cobject, int64_t new_length)
static void	FreeIOBufferData (Dart_CObject *object)
static CObject *	IllegalArgumentError ()
static CObject *	FileClosedError ()
static CObject *	NewOSError ()
static CObject *	NewOSError (OSError *os_error)

Static Public Attributes
static constexpr int	kSuccess = 0
static constexpr int	kArgumentError = 1
static constexpr int	kOSError = 2
static constexpr int	kFileClosedError = 3

Protected Member Functions
	CObject ()

Protected Attributes
Dart_CObject *	cobject_

Detailed Description

Definition at line 329 of file dartutils.h.

Constructor & Destructor Documentation

CObject() [1/2]

dart::bin::CObject::CObject ( Dart_CObject *  cobject )

inlineexplicit

Definition at line 337 of file dartutils.h.

: cobject_(cobject) {}

CObject() [2/2]

dart::bin::CObject::CObject ( )

inlineprotected

Definition at line 406 of file dartutils.h.

: cobject_(nullptr) {}

Member Function Documentation

AsApiCObject()

Dart_CObject * dart::bin::CObject::AsApiCObject ( )

inline

Definition at line 394 of file dartutils.h.

{ return cobject_; }

Bool()

CObject * dart::bin::CObject::Bool ( bool  value )

static

Definition at line 897 of file dartutils.cc.

                                 {
  return value ? &true_ : &false_;
}

byte_array_type()

Dart_TypedData_Type dart::bin::CObject::byte_array_type ( )

inline

Definition at line 339 of file dartutils.h.

                                        {
    ASSERT(type() == Dart_CObject_kTypedData ||
           type() == Dart_CObject_kExternalTypedData);
    return cobject_->value.as_typed_data.type;
  }

False()

CObject * dart::bin::CObject::False ( )

static

Definition at line 893 of file dartutils.cc.

                        {
  return &false_;
}

FileClosedError()

CObject * dart::bin::CObject::FileClosedError ( )

static

Definition at line 1038 of file dartutils.cc.

                                  {
  CObjectArray* result = new CObjectArray(CObject::NewArray(1));
  result->SetAt(0, new CObjectInt32(CObject::NewInt32(kFileClosedError)));
  return result;
}

FreeIOBufferData()

void dart::bin::CObject::FreeIOBufferData ( Dart_CObject *  object )

static

Definition at line 1025 of file dartutils.cc.

                                                    {
  ASSERT(cobject->type == Dart_CObject_kExternalTypedData);
  cobject->value.as_external_typed_data.callback(
      nullptr, cobject->value.as_external_typed_data.peer);
  cobject->value.as_external_typed_data.data = nullptr;
}

IllegalArgumentError()

CObject * dart::bin::CObject::IllegalArgumentError ( )

static

Definition at line 1032 of file dartutils.cc.

                                       {
  CObjectArray* result = new CObjectArray(CObject::NewArray(1));
  result->SetAt(0, new CObjectInt32(CObject::NewInt32(kArgumentError)));
  return result;
}

IsArray()

bool dart::bin::CObject::IsArray ( )

inline

Definition at line 353 of file dartutils.h.

{ return type() == Dart_CObject_kArray; }

IsBool()

bool dart::bin::CObject::IsBool ( )

inline

Definition at line 346 of file dartutils.h.

{ return type() == Dart_CObject_kBool; }

IsDouble()

bool dart::bin::CObject::IsDouble ( )

inline

Definition at line 351 of file dartutils.h.

{ return type() == Dart_CObject_kDouble; }

IsFalse()

bool dart::bin::CObject::IsFalse ( )

inline

Definition at line 365 of file dartutils.h.

                 {
    return type() == Dart_CObject_kBool && !cobject_->value.as_bool;
  }

IsInt32()

bool dart::bin::CObject::IsInt32 ( )

inline

Definition at line 347 of file dartutils.h.

{ return type() == Dart_CObject_kInt32; }

IsInt32OrInt64()

bool dart::bin::CObject::IsInt32OrInt64 ( )

inline

Definition at line 349 of file dartutils.h.

{ return IsInt32() || IsInt64(); }

IsInt64()

bool dart::bin::CObject::IsInt64 ( )

inline

Definition at line 348 of file dartutils.h.

{ return type() == Dart_CObject_kInt64; }

IsIntptr()

bool dart::bin::CObject::IsIntptr ( )

inline

Definition at line 350 of file dartutils.h.

{ return IsInt32OrInt64(); }

IsNull()

bool dart::bin::CObject::IsNull ( )

inline

Definition at line 345 of file dartutils.h.

{ return type() == Dart_CObject_kNull; }

IsSendPort()

bool dart::bin::CObject::IsSendPort ( )

inline

Definition at line 359 of file dartutils.h.

{ return type() == Dart_CObject_kSendPort; }

IsString()

bool dart::bin::CObject::IsString ( )

inline

Definition at line 352 of file dartutils.h.

{ return type() == Dart_CObject_kString; }

IsTrue()

bool dart::bin::CObject::IsTrue ( )

inline

Definition at line 361 of file dartutils.h.

                {
    return type() == Dart_CObject_kBool && cobject_->value.as_bool;
  }

IsTypedData()

bool dart::bin::CObject::IsTypedData ( )

inline

Definition at line 354 of file dartutils.h.

{ return type() == Dart_CObject_kTypedData; }

IsUint8Array()

bool dart::bin::CObject::IsUint8Array ( )

inline

Definition at line 355 of file dartutils.h.

                      {
    return type() == Dart_CObject_kTypedData &&
           byte_array_type() == Dart_TypedData_kUint8;
  }

NewArray()

Dart_CObject * dart::bin::CObject::NewArray ( intptr_t  length )

static

Definition at line 942 of file dartutils.cc.

                                               {
  Dart_CObject* cobject =
      New(Dart_CObject_kArray, length * sizeof(Dart_CObject*));  // NOLINT
  cobject->value.as_array.length = length;
  cobject->value.as_array.values =
      reinterpret_cast<Dart_CObject**>(cobject + 1);
  return cobject;
}

NewDouble()

Dart_CObject * dart::bin::CObject::NewDouble ( double  value )

static

Definition at line 927 of file dartutils.cc.

                                             {
  Dart_CObject* cobject = New(Dart_CObject_kDouble);
  cobject->value.as_double = value;
  return cobject;
}

NewExternalUint8Array()

Dart_CObject * dart::bin::CObject::NewExternalUint8Array ( intptr_t  length, uint8_t *  data, void *  peer, Dart_HandleFinalizer  callback  )

static

Definition at line 961 of file dartutils.cc.

                                                                            {
  Dart_CObject* cobject = New(Dart_CObject_kExternalTypedData);
  cobject->value.as_external_typed_data.type = Dart_TypedData_kUint8;
  cobject->value.as_external_typed_data.length = length;
  cobject->value.as_external_typed_data.data = data;
  cobject->value.as_external_typed_data.peer = peer;
  cobject->value.as_external_typed_data.callback = callback;
  return cobject;
}

NewInt32()

Dart_CObject * dart::bin::CObject::NewInt32 ( int32_t  value )

static

Definition at line 908 of file dartutils.cc.

                                             {
  Dart_CObject* cobject = New(Dart_CObject_kInt32);
  cobject->value.as_int32 = value;
  return cobject;
}

NewInt64()

Dart_CObject * dart::bin::CObject::NewInt64 ( int64_t  value )

static

Definition at line 914 of file dartutils.cc.

                                             {
  Dart_CObject* cobject = New(Dart_CObject_kInt64);
  cobject->value.as_int64 = value;
  return cobject;
}

NewIntptr()

Dart_CObject * dart::bin::CObject::NewIntptr ( intptr_t  value )

static

Definition at line 920 of file dartutils.cc.

                                               {
  // Pointer values passed as intptr_t are always send as int64_t.
  Dart_CObject* cobject = New(Dart_CObject_kInt64);
  cobject->value.as_int64 = value;
  return cobject;
}

NewIOBuffer()

Dart_CObject * dart::bin::CObject::NewIOBuffer ( int64_t  length )

static

Definition at line 984 of file dartutils.cc.

                                                 {
  // Make sure that we do not have an integer overflow here. Actual check
  // against max elements will be done at the time of writing, as the constant
  // is not part of the public API.
  if ((length < 0) || (length > kIntptrMax)) {
    return nullptr;
  }
  uint8_t* data = IOBuffer::Allocate(static_cast<intptr_t>(length));
  if (data == nullptr) {
    return nullptr;
  }
  return NewExternalUint8Array(static_cast<intptr_t>(length), data, data,
                               IOBuffer::Finalizer);
}

NewNativePointer()

Dart_CObject * dart::bin::CObject::NewNativePointer ( intptr_t  ptr, intptr_t  size, Dart_HandleFinalizer  callback  )

static

Definition at line 974 of file dartutils.cc.

                                                                       {
  Dart_CObject* cobject = New(Dart_CObject_kNativePointer);
  cobject->value.as_native_pointer.ptr = ptr;
  cobject->value.as_native_pointer.size = size;
  cobject->value.as_native_pointer.callback = callback;
  return cobject;
}

NewOSError() [1/2]

CObject * dart::bin::CObject::NewOSError ( )

static

Definition at line 1044 of file dartutils.cc.

                             {
  OSError os_error;
  return NewOSError(&os_error);
}

NewOSError() [2/2]

CObject * dart::bin::CObject::NewOSError ( OSError *  os_error )

static

Definition at line 1049 of file dartutils.cc.

                                              {
  CObject* error_message =
      new CObjectString(CObject::NewString(os_error->message()));
  CObjectArray* result = new CObjectArray(CObject::NewArray(3));
  result->SetAt(0, new CObjectInt32(CObject::NewInt32(kOSError)));
  result->SetAt(1, new CObjectInt32(CObject::NewInt32(os_error->code())));
  result->SetAt(2, error_message);
  return result;
}

NewString()

Dart_CObject * dart::bin::CObject::NewString ( const char *  str )

static

Definition at line 933 of file dartutils.cc.

                                                {
  intptr_t length = strlen(str);
  Dart_CObject* cobject = New(Dart_CObject_kString, length + 1);
  char* payload = reinterpret_cast<char*>(cobject + 1);
  memmove(payload, str, length + 1);
  cobject->value.as_string = payload;
  return cobject;
}

NewUint8Array()

Dart_CObject * dart::bin::CObject::NewUint8Array ( const void *  data, intptr_t  length  )

static

Definition at line 951 of file dartutils.cc.

                                                                      {
  Dart_CObject* cobject = New(Dart_CObject_kTypedData, length);
  memmove(reinterpret_cast<uint8_t*>(cobject + 1), data, length);
  cobject->value.as_typed_data.type = Dart_TypedData_kUint8;
  cobject->value.as_typed_data.length = length;
  cobject->value.as_typed_data.values =
      reinterpret_cast<const uint8_t*>(cobject + 1);
  return cobject;
}

Null()

CObject * dart::bin::CObject::Null ( )

static

Definition at line 885 of file dartutils.cc.

                       {
  return &null_;
}

operator new()

void * dart::bin::CObject::operator new ( size_t  size )

inline

Definition at line 369 of file dartutils.h.

{ return Dart_ScopeAllocate(size); }

ShrinkIOBuffer()

void dart::bin::CObject::ShrinkIOBuffer ( Dart_CObject *  cobject, int64_t  new_length  )

static

Definition at line 999 of file dartutils.cc.

                                                                      {
  if (cobject == nullptr) return;
  ASSERT(cobject->type == Dart_CObject_kExternalTypedData);
 
  const auto old_data = cobject->value.as_external_typed_data.data;
  const auto old_length = cobject->value.as_external_typed_data.length;
 
  // We only shrink IOBuffers, never grow them.
  ASSERT(0 <= new_length && new_length <= old_length);
 
  // We only reallocate if we think the freed space is worth reallocating.
  // We consider it worthwhile when freed space is >=25% and we have at
  // least 100 free bytes.
  const auto free_memory = old_length - new_length;
  if ((old_length >> 2) <= free_memory && 100 <= free_memory) {
    const auto new_data = IOBuffer::Reallocate(old_data, new_length);
    if (new_data != nullptr) {
      cobject->value.as_external_typed_data.data = new_data;
      cobject->value.as_external_typed_data.peer = new_data;
    }
  }
 
  // The typed data object always has to have the shranken length.
  cobject->value.as_external_typed_data.length = new_length;
}

True()

CObject * dart::bin::CObject::True ( )

static

Definition at line 889 of file dartutils.cc.

                       {
  return &true_;
}

type()

Dart_CObject_Type dart::bin::CObject::type ( )

inline

Definition at line 338 of file dartutils.h.

{ return cobject_->type; }

Member Data Documentation

cobject_

Dart_CObject* dart::bin::CObject::cobject_

protected

Definition at line 407 of file dartutils.h.

kArgumentError

constexpr int dart::bin::CObject::kArgumentError = 1

staticconstexpr

Definition at line 333 of file dartutils.h.

kFileClosedError

constexpr int dart::bin::CObject::kFileClosedError = 3

staticconstexpr

Definition at line 335 of file dartutils.h.

kOSError

constexpr int dart::bin::CObject::kOSError = 2

staticconstexpr

Definition at line 334 of file dartutils.h.

kSuccess

constexpr int dart::bin::CObject::kSuccess = 0

staticconstexpr

Definition at line 332 of file dartutils.h.

---

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

• third_party/dart-lang/sdk/runtime/bin/dartutils.h
• third_party/dart-lang/sdk/runtime/bin/dartutils.cc