object - D Programming Language - Digital Mars

D Programming Language 2.0

- Comments
- D
- Search
- Home

Last update Wed Aug 1 09:43:19 2012

# object

Forms the symbols available to all D programs. Includes Object, which is the root of the class object hierarchy. This module is implicitly imported.

License:
Boost License 1.0.

Authors:
Walter Bright, Sean Kelly

class Object;
  All D class objects inherit from Object.

  string toString();
    Convert Object to a human readable string.

  nothrow @trusted hash_t toHash();
    Compute hash function for Object.

  int opCmp(Object o);
    Compare with another Object obj.

    Returns:

    this < obj | < 0
    this == obj | 0
    this > obj | > 0
    this < obj | < 0
    this == obj | 0
    this > obj | > 0

  equals_t opEquals(Object o);
    Returns !=0 if this object does have the same contents as obj.

  static Object factory(string classname);
    Create instance of class specified by classname. The class must either have no constructors or have a default constructor.

    Returns:
    null if failed

bool opEquals(const Object lhs, const Object rhs);
  Returns true if lhs and rhs are equal.

struct Interface;
  Information about an interface. When an object is accessed via an interface, an Interface* appears as the first entry in its vtbl.

  TypeInfo_Class classinfo;
    .classinfo for this interface (not for containing class)

  ptrdiff_t offset;
    offset to Interface 'this' from Object 'this'

alias Classinfo;
  Runtime type information about a class. Can be retrieved for any class type or instance by using the .classinfo property. A pointer to this appears as the first entry in the class's vtbl[].

struct OffsetTypeInfo;
  Array of pairs giving the offset and type information for each member in an aggregate.

  size_t offset;
    Offset of member from start of object

  TypeInfo ti;
    TypeInfo for this member

class TypeInfo;
  Runtime type information about a type. Can be retrieved for any type using a TypeidExpression.

  const nothrow @trusted hash_t getHash(in void* p);
    Returns a hash of the instance of a type.

  const equals_t equals(in void* p1, in void* p2);
    Compares two instances for equality.

  const int compare(in void* p1, in void* p2);
    Compares two instances for <, ==, or >.

  const pure nothrow @property @safe size_t tsize();
    Returns size of the type.

  const void swap(void* p1, void* p2);
    Swaps two instances of the type.

  const pure nothrow @property const(TypeInfo) next();
    Get TypeInfo for 'next' type, as defined by what kind of type this is, null if none.

  const pure nothrow @safe const(void)[] init();
    Return default initializer. If the type should be initialized to all zeros, an array with a null ptr and a length equal to the type size will be returned.

  const pure nothrow @property @safe uint flags();
    Get flags for type: 1 means GC should scan for pointers

  const const(OffsetTypeInfo)[] offTi();
    Get type information on the contents of the type; null if not available

  const void destroy(void* p);
    Run the destructor on the object and all its sub-objects

  const void postblit(void* p);
    Run the postblit on the object and all its sub-objects

  const pure nothrow @property @safe size_t talign();
    Return alignment of type

  const pure nothrow @property @safe immutable(void)* rtInfo();
    Return info used by the garbage collector to do precise collection.

class TypeInfo_Class: object.TypeInfo;
  Runtime type information about a class. Can be retrieved from an object instance by using the .classinfo property.

  byte[] init;
    class static initializer (init.length gives size in bytes of class)

  string name;
    class name

  void*[] vtbl;
    virtual function pointer table

  Interface[] interfaces;
    interfaces this class implements

  TypeInfo_Class base;
    base class

  static const(TypeInfo_Class) find(in char[] classname);
    Search all modules for TypeInfo_Class corresponding to classname.

    Returns:
    null if not found

  const Object create();
    Create instance of Object represented by 'this'.

class Throwable;

void rt_setTraceHandler(TraceHandler h);
  Overrides the default trace hander with a user-supplied version.

  Parameters:

  TraceHandler h | The new trace handler. Set to null to use the default handler.

TraceHandler rt_getTraceHandler();
  Return the current trace handler

Throwable.TraceInfo _d_traceContext(void* ptr = null);
  This function will be called when an exception is constructed. The user-supplied trace handler will be called if one has been supplied, otherwise no trace will be generated.

  Parameters:

  void* ptr | A pointer to the location from which to generate the trace, or null if the trace should be generated from within the trace handler itself.

  Returns:
  An object describing the current calling context or null if no handler is supplied.

alias IMonitor;

void destroy(T)(T obj);
  Destroys the given object and puts it in an invalid state. It's used to destroy an object so that any cleanup which its destructor or finalizer does is done and so that it no longer references any other objects. It does not initiate a GC cycle or free any GC memory.

pure nothrow size_t capacity(T)(T[] arr);
  (Property) Get the current capacity of an array. The capacity is the number of elements that the array can grow to before the array must be extended/reallocated.

pure nothrow size_t reserve(T)(ref T[] arr, size_t newcapacity);
  Try to reserve capacity for an array. The capacity is the number of elements that the array can grow to before the array must be extended/reallocated.

  The return value is the new capacity of the array (which may be larger than the requested capacity).

void assumeSafeAppend(T)(T[] arr);
  Assume that it is safe to append to this array. Appends made to this array after calling this function may append in place, even if the array was a slice of a larger array to begin with.

  Use this only when you are sure no elements are in use beyond the array in the memory block. If there are, those elements could be overwritten by appending to this array.

  Calling this function, and then using references to data located after the given array results in undefined behavior.

bool _ArrayEq(T1, T2)(T1[] a1, T2[] a2);
  Helper function used to see if two containers of different types have the same contents in the same sequence.

template RTInfo(T)
  Create RTInfo for type T

Copyright Digital Mars 2000 - 2011. | Page generated by Ddoc.