#include <MRCMisc/common.h>
#include <MRCMisc/exports.h>
#include <stddef.h>
Go to the source code of this file.
◆ MR_std_string
A heap-allocated null-terminated string. 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_std_string_AssignFrom()
MRC_API void MR_std_string_AssignFrom |
( |
MR_std_string * | _this, |
|
|
const char * | other, |
|
|
const char * | other_end ) |
Assigns the contents. Parameter _this
can not be null. It is a single object. Parameter other
can not be null. If other_end
is null, then other
is assumed to be null-terminated.
◆ MR_std_string_AssignFromAnother()
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_string_ConstructFrom()
Constructs a new instance. Parameter other
can not be null. If other_end
is null, then other
is assumed to be null-terminated. Never returns null. Returns an instance allocated on the heap! Must call MR_std_string_Destroy()
to free it when you're done using it.
◆ MR_std_string_ConstructFromAnother()
Constructs a copy of another instance. The source remains alive. Never returns null. Returns an instance allocated on the heap! Must call MR_std_string_Destroy()
to free it when you're done using it.
◆ MR_std_string_Data()
Returns the string contents, which are always null-terminated. Parameter _this
can not be null. It is a single object.
◆ MR_std_string_DataEnd()
Returns a pointer to the end of string, to its null-terminator. Parameter _this
can not be null. It is a single object.
◆ MR_std_string_DefaultConstruct()
Constructs an empty (default-constructed) instance. Never returns null. Returns an instance allocated on the heap! Must call MR_std_string_Destroy()
to free it when you're done using it.
◆ MR_std_string_DefaultConstructArray()
◆ MR_std_string_Destroy()
Destroys a heap-allocated instance of MR_std_string
. Does nothing if the pointer is null.
◆ MR_std_string_DestroyArray()
Destroys a heap-allocated array of MR_std_string
. Does nothing if the pointer is null.
◆ MR_std_string_MutableData()
Returns the string contents, which are always null-terminated. This version returns a non-const pointer. Parameter _this
can not be null. It is a single object.
◆ MR_std_string_MutableDataEnd()
Returns a pointer to the end of string, to its null-terminator. This version returns a non-const pointer. Parameter _this
can not be null. It is a single object.
◆ MR_std_string_OffsetMutablePtr()
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_string_OffsetPtr()
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_string_Size()
The number of characters in the string, excluding the null-terminator. Parameter _this
can not be null. It is a single object.