std_shared_ptr_const_MR_Mesh.h File Reference

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

Go to the source code of this file.

Typedefs
typedef struct MR_std_shared_ptr_const_void	MR_std_shared_ptr_const_void

Functions
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_DefaultConstruct (void)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_DefaultConstructArray (size_t num_elems)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_ConstructFromAnother (MR_PassBy other_pass_by, MR_std_shared_ptr_const_MR_Mesh *other)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_AssignFromAnother (MR_std_shared_ptr_const_MR_Mesh *_this, MR_PassBy other_pass_by, MR_std_shared_ptr_const_MR_Mesh *other)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_Destroy (const MR_std_shared_ptr_const_MR_Mesh *_this)
	Destroys a heap-allocated instance of MR_std_shared_ptr_const_MR_Mesh. Does nothing if the pointer is null.
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_DestroyArray (const MR_std_shared_ptr_const_MR_Mesh *_this)
	Destroys a heap-allocated array of MR_std_shared_ptr_const_MR_Mesh. Does nothing if the pointer is null.
MRC_API const MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_OffsetPtr (const MR_std_shared_ptr_const_MR_Mesh *ptr, ptrdiff_t i)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_OffsetMutablePtr (MR_std_shared_ptr_const_MR_Mesh *ptr, ptrdiff_t i)
MRC_API const MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_get (const MR_std_shared_ptr_const_MR_Mesh *_this)
MRC_API bool	MR_std_shared_ptr_const_MR_Mesh_has_value (const MR_std_shared_ptr_const_MR_Mesh *_this)
MRC_API int	MR_std_shared_ptr_const_MR_Mesh_use_count (const MR_std_shared_ptr_const_MR_Mesh *_this)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_reset (MR_std_shared_ptr_const_MR_Mesh *_this)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_ConstructFromValue (MR_PassBy value_pass_by, MR_Mesh *value)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_Construct (const MR_Mesh *ptr)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_Assign (MR_std_shared_ptr_const_MR_Mesh *_this, const MR_Mesh *ptr)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_ConstructNonOwning (const MR_Mesh *ptr)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_AssignNonOwning (MR_std_shared_ptr_const_MR_Mesh *_this, const MR_Mesh *ptr)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_ConstructFromMutable (MR_PassBy ptr_pass_by, MR_std_shared_ptr_MR_Mesh *ptr)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_AssignFromMutable (MR_std_shared_ptr_const_MR_Mesh *_this, MR_PassBy ptr_pass_by, MR_std_shared_ptr_MR_Mesh *ptr)
MRC_API MR_std_shared_ptr_const_MR_Mesh *	MR_std_shared_ptr_const_MR_Mesh_ConstructAliasing (MR_PassBy ownership_pass_by, MR_std_shared_ptr_const_void *ownership, const MR_Mesh *ptr)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_AssignAliasing (MR_std_shared_ptr_const_MR_Mesh *_this, MR_PassBy ownership_pass_by, MR_std_shared_ptr_const_void *ownership, const MR_Mesh *ptr)
MRC_API MR_std_shared_ptr_const_void *	MR_std_shared_ptr_const_MR_Mesh_ConvertTo_MR_std_shared_ptr_const_void (const MR_std_shared_ptr_const_MR_Mesh *_this)
MRC_API void	MR_std_shared_ptr_const_MR_Mesh_AssignTo_MR_std_shared_ptr_const_void (const MR_std_shared_ptr_const_MR_Mesh *_this, MR_std_shared_ptr_const_void *_target)

Typedef Documentation

MR_std_shared_ptr_const_void

typedef struct MR_std_shared_ptr_const_void MR_std_shared_ptr_const_void

Wraps a pointer to a single shared reference-counted heap-allocated const void. 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).

Function Documentation

MR_std_shared_ptr_const_MR_Mesh_Assign()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_Assign	(	MR_std_shared_ptr_const_MR_Mesh *	_this,
		const MR_Mesh *	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_Mesh_Destroy() on it automatically.

MR_std_shared_ptr_const_MR_Mesh_AssignAliasing()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_AssignAliasing	(	MR_std_shared_ptr_const_MR_Mesh *	_this,
		MR_PassBy	ownership_pass_by,
		MR_std_shared_ptr_const_void *	ownership,
		const MR_Mesh *	ptr )

The aliasing assignment. Overwrite an existing instance, copying ownership from an existing shared pointer and storing an arbitrary raw pointer. The input pointer can be reinterpreted from any other std::shared_ptr<T> to avoid constructing a new std::shared_ptr<void>. Parameter _this can not be null. It is a single object. The reference to the parameter ptr might be preserved in this object. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_AssignFromAnother()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_AssignFromAnother	(	MR_std_shared_ptr_const_MR_Mesh *	_this,
		MR_PassBy	other_pass_by,
		MR_std_shared_ptr_const_MR_Mesh *	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. The reference to the parameter other might be preserved in this object. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_AssignFromMutable()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_AssignFromMutable	(	MR_std_shared_ptr_const_MR_Mesh *	_this,
		MR_PassBy	ptr_pass_by,
		MR_std_shared_ptr_MR_Mesh *	ptr )

Overwrite the existing instance with a non-const pointer to the same type. Parameter _this can not be null. It is a single object.

MR_std_shared_ptr_const_MR_Mesh_AssignNonOwning()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_AssignNonOwning	(	MR_std_shared_ptr_const_MR_Mesh *	_this,
		const MR_Mesh *	ptr )

Overwrite the existing instance with a non-owning pointer. The previously owned object, if any, has its reference count decremented. Parameter _this can not be null. It is a single object. The reference to the parameter ptr might be preserved in this object. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_AssignTo_MR_std_shared_ptr_const_void()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_AssignTo_MR_std_shared_ptr_const_void	(	const MR_std_shared_ptr_const_MR_Mesh *	_this,
		MR_std_shared_ptr_const_void *	_target )

Overwrites an existing std::shared_ptr<void> to point to the same object as this instance. Parameter _this can not be null. It is a single object. Parameter _target can not be null. It is a single object.

MR_std_shared_ptr_const_MR_Mesh_Construct()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_Construct

(

const MR_Mesh *

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_Mesh_Destroy() on it automatically. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it.

MR_std_shared_ptr_const_MR_Mesh_ConstructAliasing()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_ConstructAliasing	(	MR_PassBy	ownership_pass_by,
		MR_std_shared_ptr_const_void *	ownership,
		const MR_Mesh *	ptr )

The aliasing constructor. Create a new instance, copying ownership from an existing shared pointer and storing an arbitrary raw pointer. The input pointer can be reinterpreted from any other std::shared_ptr<T> to avoid constructing a new std::shared_ptr<void>. The reference to the parameter ptr might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_ConstructFromAnother()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_ConstructFromAnother	(	MR_PassBy	other_pass_by,
		MR_std_shared_ptr_const_MR_Mesh *	other )

Constructs a copy of another instance. The source remains alive. The reference to the parameter other might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_ConstructFromMutable()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_ConstructFromMutable	(	MR_PassBy	ptr_pass_by,
		MR_std_shared_ptr_MR_Mesh *	ptr )

Create a new instance from a non-const pointer to the same type. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it.

MR_std_shared_ptr_const_MR_Mesh_ConstructFromValue()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_ConstructFromValue	(	MR_PassBy	value_pass_by,
		MR_Mesh *	value )

Construct from a value. The reference to the parameter value might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_ConstructNonOwning()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_ConstructNonOwning

(

const MR_Mesh *

ptr

)

Create a new instance, storing a non-owning pointer. The reference to the parameter ptr might be preserved in the constructed object. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_MR_Mesh_Destroy() to free it when you're done using it. When this function is called, this object will drop any object references it held previously.

MR_std_shared_ptr_const_MR_Mesh_ConvertTo_MR_std_shared_ptr_const_void()

MRC_API MR_std_shared_ptr_const_void * MR_std_shared_ptr_const_MR_Mesh_ConvertTo_MR_std_shared_ptr_const_void

(

const MR_std_shared_ptr_const_MR_Mesh *

_this

)

Creates an untyped std::shared_ptr<void> pointing to the same object as the source typed pointer. Parameter _this can not be null. It is a single object. Never returns null. Returns an instance allocated on the heap! Must call MR_std_shared_ptr_const_void_Destroy() to free it when you're done using it.

MR_std_shared_ptr_const_MR_Mesh_DefaultConstruct()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_DefaultConstruct

(

void

)

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

MR_std_shared_ptr_const_MR_Mesh_DefaultConstructArray()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_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_const_MR_Mesh_DestroyArray(). Use MR_std_shared_ptr_const_MR_Mesh_OffsetMutablePtr() and MR_std_shared_ptr_const_MR_Mesh_OffsetPtr() to access the array elements.

MR_std_shared_ptr_const_MR_Mesh_Destroy()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_Destroy

(

const MR_std_shared_ptr_const_MR_Mesh *

_this

)

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

MR_std_shared_ptr_const_MR_Mesh_DestroyArray()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_DestroyArray

(

const MR_std_shared_ptr_const_MR_Mesh *

_this

)

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

MR_std_shared_ptr_const_MR_Mesh_get()

MRC_API const MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_get

(

const MR_std_shared_ptr_const_MR_Mesh *

_this

)

Returns the stored pointer, possibly null. Parameter _this can not be null. It is a single object. The reference to this object might be preserved as the return value.

MR_std_shared_ptr_const_MR_Mesh_has_value()

MRC_API bool MR_std_shared_ptr_const_MR_Mesh_has_value

(

const MR_std_shared_ptr_const_MR_Mesh *

_this

)

Returns true if non-null. Parameter _this can not be null. It is a single object.

MR_std_shared_ptr_const_MR_Mesh_OffsetMutablePtr()

MRC_API MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_OffsetMutablePtr	(	MR_std_shared_ptr_const_MR_Mesh *	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. The reference to the parameter ptr might be preserved in the return value.

MR_std_shared_ptr_const_MR_Mesh_OffsetPtr()

MRC_API const MR_std_shared_ptr_const_MR_Mesh * MR_std_shared_ptr_const_MR_Mesh_OffsetPtr	(	const MR_std_shared_ptr_const_MR_Mesh *	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. The reference to the parameter ptr might be preserved in the return value.

MR_std_shared_ptr_const_MR_Mesh_reset()

MRC_API void MR_std_shared_ptr_const_MR_Mesh_reset

(

MR_std_shared_ptr_const_MR_Mesh *

_this

)

Resets the pointer to null. Parameter _this can not be null. It is a single object.

MR_std_shared_ptr_const_MR_Mesh_use_count()

MRC_API int MR_std_shared_ptr_const_MR_Mesh_use_count

(

const MR_std_shared_ptr_const_MR_Mesh *

_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_const_MR_Mesh_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.