std_shared_ptr_MR_VisualObject.h File Reference

#include <MRCMisc/common.h>
#include <MRCMisc/exports.h>
#include <stddef.h>

Go to the source code of this file.

Typedefs
typedef struct MR_VisualObject	MR_VisualObject
typedef struct MR_std_shared_ptr_MR_VisualObject	MR_std_shared_ptr_MR_VisualObject

Functions
MRC_API MR_std_shared_ptr_MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_DefaultConstruct (void)
MRC_API MR_std_shared_ptr_MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_DefaultConstructArray (size_t num_elems)
MRC_API MR_std_shared_ptr_MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_ConstructFromAnother (MR_PassBy other_pass_by, MR_std_shared_ptr_MR_VisualObject *other)
MRC_API void	MR_std_shared_ptr_MR_VisualObject_AssignFromAnother (MR_std_shared_ptr_MR_VisualObject *_this, MR_PassBy other_pass_by, MR_std_shared_ptr_MR_VisualObject *other)
MRC_API void	MR_std_shared_ptr_MR_VisualObject_Destroy (const MR_std_shared_ptr_MR_VisualObject *_this)
	Destroys a heap-allocated instance of MR_std_shared_ptr_MR_VisualObject. Does nothing if the pointer is null.
MRC_API void	MR_std_shared_ptr_MR_VisualObject_DestroyArray (const MR_std_shared_ptr_MR_VisualObject *_this)
	Destroys a heap-allocated array of MR_std_shared_ptr_MR_VisualObject. Does nothing if the pointer is null.
MRC_API const MR_std_shared_ptr_MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_OffsetPtr (const MR_std_shared_ptr_MR_VisualObject *ptr, ptrdiff_t i)
	Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element.
MRC_API MR_std_shared_ptr_MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_OffsetMutablePtr (MR_std_shared_ptr_MR_VisualObject *ptr, ptrdiff_t i)
	Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element.
MRC_API MR_VisualObject *	MR_std_shared_ptr_MR_VisualObject_Get (const MR_std_shared_ptr_MR_VisualObject *_this)
MRC_API int	MR_std_shared_ptr_MR_VisualObject_UseCount (const MR_std_shared_ptr_MR_VisualObject *_this)
MRC_API void	MR_std_shared_ptr_MR_VisualObject_Construct (MR_VisualObject *ptr)
MRC_API void	MR_std_shared_ptr_MR_VisualObject_Assign (MR_std_shared_ptr_MR_VisualObject *_this, MR_VisualObject *ptr)

Typedef Documentation

MR_std_shared_ptr_MR_VisualObject

typedef struct MR_std_shared_ptr_MR_VisualObject MR_std_shared_ptr_MR_VisualObject

Wraps a pointer to a single shared reference-counted heap-allocated MR::VisualObject. Supported MR_PassBy modes: MR_PassBy_DefaultConstruct, MR_PassBy_Copy, MR_PassBy_Move, (and MR_PassBy_DefaultArgument and MR_PassBy_NoObject if supported by the callee).

MR_VisualObject

typedef struct MR_VisualObject MR_VisualObject

Function Documentation

MR_std_shared_ptr_MR_VisualObject_Assign()

MRC_API void MR_std_shared_ptr_MR_VisualObject_Assign	(	MR_std_shared_ptr_MR_VisualObject *	_this,
		MR_VisualObject *	ptr )

Overwrite the existing instance, taking ownership of an existing pointer. The previously owned object, if any, has its reference count decremented. Parameter _this can not be null. It is a single object. Parameter ptr should point to a single object rather than to an array. Parameter ptr takes ownership of the passed pointer (if not null), and will later call MR_VisualObject_Destroy() on it automatically.

MR_std_shared_ptr_MR_VisualObject_AssignFromAnother()

MRC_API void MR_std_shared_ptr_MR_VisualObject_AssignFromAnother	(	MR_std_shared_ptr_MR_VisualObject *	_this,
		MR_PassBy	other_pass_by,
		MR_std_shared_ptr_MR_VisualObject *	other )

Assigns the contents from another instance. Both objects remain alive after the call. Parameter _this can not be null. It is a single object.

MR_std_shared_ptr_MR_VisualObject_Construct()

MRC_API void MR_std_shared_ptr_MR_VisualObject_Construct

(

MR_VisualObject *

ptr

)

Create a new instance, taking ownership of an existing pointer. Parameter ptr should point to a single object rather than to an array. Parameter ptr takes ownership of the passed pointer (if not null), and will later call MR_VisualObject_Destroy() on it automatically.

MR_std_shared_ptr_MR_VisualObject_ConstructFromAnother()

MRC_API MR_std_shared_ptr_MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_ConstructFromAnother	(	MR_PassBy	other_pass_by,
		MR_std_shared_ptr_MR_VisualObject *	other )

Constructs a copy of another instance. The source remains alive. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_MR_VisualObject_Destroy() to free it when you're done using it.

MR_std_shared_ptr_MR_VisualObject_DefaultConstruct()

MRC_API MR_std_shared_ptr_MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_DefaultConstruct

(

void

)

Constructs an empty (default-constructed) instance. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_MR_VisualObject_Destroy() to free it when you're done using it.

MR_std_shared_ptr_MR_VisualObject_DefaultConstructArray()

MRC_API MR_std_shared_ptr_MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_DefaultConstructArray

(

size_t

num_elems

)

Constructs an array of empty (default-constructed) instances, of the specified size. Will never return null. The array must be destroyed using MR_std_shared_ptr_MR_VisualObject_DestroyArray(). Use MR_std_shared_ptr_MR_VisualObject_OffsetMutablePtr() and MR_std_shared_ptr_MR_VisualObject_OffsetPtr() to access the array elements.

MR_std_shared_ptr_MR_VisualObject_Destroy()

MRC_API void MR_std_shared_ptr_MR_VisualObject_Destroy

(

const MR_std_shared_ptr_MR_VisualObject *

_this

)

Destroys a heap-allocated instance of MR_std_shared_ptr_MR_VisualObject. Does nothing if the pointer is null.

MR_std_shared_ptr_MR_VisualObject_DestroyArray()

MRC_API void MR_std_shared_ptr_MR_VisualObject_DestroyArray

(

const MR_std_shared_ptr_MR_VisualObject *

_this

)

Destroys a heap-allocated array of MR_std_shared_ptr_MR_VisualObject. Does nothing if the pointer is null.

MR_std_shared_ptr_MR_VisualObject_Get()

MRC_API MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_Get

(

const MR_std_shared_ptr_MR_VisualObject *

_this

)

Returns the stored pointer, possibly null. Parameter _this can not be null. It is a single object.

MR_std_shared_ptr_MR_VisualObject_OffsetMutablePtr()

MRC_API MR_std_shared_ptr_MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_OffsetMutablePtr	(	MR_std_shared_ptr_MR_VisualObject *	ptr,
		ptrdiff_t	i )

Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element.

MR_std_shared_ptr_MR_VisualObject_OffsetPtr()

MRC_API const MR_std_shared_ptr_MR_VisualObject * MR_std_shared_ptr_MR_VisualObject_OffsetPtr	(	const MR_std_shared_ptr_MR_VisualObject *	ptr,
		ptrdiff_t	i )

Offsets a pointer to an array element by i positions (not bytes). Use only if you're certain that the pointer points to an array element.

MR_std_shared_ptr_MR_VisualObject_UseCount()

MRC_API int MR_std_shared_ptr_MR_VisualObject_UseCount

(

const MR_std_shared_ptr_MR_VisualObject *

_this

)

How many shared pointers share the managed object. Zero if no object is being managed. This being zero usually conincides with MR_std_shared_ptr_MR_VisualObject_Get() returning null, but is ultimately orthogonal. Note that in multithreaded environments, the only safe way to use this number is comparing it with zero. Positive values might change by the time you get to use them. Parameter _this can not be null. It is a single object.