std.typecons.Rebindable/rebindable - multiple declarations
Function rebindable
This function simply returns the Rebindable object passed in. It's useful
in generic programming cases when a given object may be either a regular
class or a Rebindable.
Parameters
| Name | Description |
|---|---|
| obj | An instance of Rebindable!T. |
Returns
obj without any modification.
Example
class C
{
int payload;
this(int p) { payload = p; }
}
const c = new C(1);
auto c2 = cFunction rebindable
Convenience function for creating a Rebindable using automatic type
inference.
Rebindable!T rebindable(T)
(
T obj
)
if (is(T == class) || is(T == interface) || isDynamicArray!T || isAssociativeArray!T);
Parameters
| Name | Description |
|---|---|
| obj | A reference to an object, interface, associative array, or an array slice
to initialize the Rebindable with. |
Returns
A newly constructed Rebindable initialized with the given reference.
Example
class C
{
int payload;
this(int p) { payload = p; }
}
const c = new C(1);
auto c2 = cAlias Rebindable
Rebindable!(T) is a simple, efficient wrapper that behaves just
like an object of type T, except that you can reassign it to
refer to another object. For completeness, Rebindable!(T) aliases
itself away to T if T is a non-const object type.
You may want to use Rebindable when you want to have mutable
storage referring to const objects, for example an array of
references that must be sorted in place. Rebindable does not
break the soundness of D's type system and does not incur any of the
risks usually associated with cast.
Parameters
| Name | Description |
|---|---|
| T | An object, interface, array slice type, or associative array type. |
Example
Regular const object references cannot be reassigned.
class Widget { int x; int y() @safe const { return x; } }
const a = new Widget;
// Fine
aExample
However, Rebindable!(Widget) does allow reassignment,
while otherwise behaving exactly like a const Widget.
class Widget { int x; int y() const @safe { return x; } }
auto a = Rebindable!(const Widget)(new Widget);
// Fine
aAuthors
Andrei Alexandrescu, Bartosz Milewski, Don Clugston, Shin Fujishiro, Kenji Hara