memory.c File Reference

#include <assert.h>
#include <inttypes.h>
#include <stdbool.h>
#include <string.h>
#include "nvim/api/extmark.h"
#include "nvim/context.h"
#include "nvim/decoration.h"
#include "nvim/eval.h"
#include "nvim/highlight.h"
#include "nvim/lua/executor.h"
#include "nvim/memfile.h"
#include "nvim/memory.h"
#include "nvim/message.h"
#include "nvim/sign.h"
#include "nvim/ui.h"
#include "nvim/vim.h"

Functions
void	try_to_free_memory (void)
void *	try_malloc (size_t size) FUNC_ATTR_MALLOC FUNC_ATTR_ALLOC_SIZE(1)
void *	verbose_try_malloc (size_t size) FUNC_ATTR_MALLOC FUNC_ATTR_ALLOC_SIZE(1)
void *	xmalloc (size_t size) FUNC_ATTR_MALLOC FUNC_ATTR_ALLOC_SIZE(1) FUNC_ATTR_NONNULL_RET
void	xfree (void *ptr)
void *	xcalloc (size_t count, size_t size) FUNC_ATTR_MALLOC FUNC_ATTR_ALLOC_SIZE_PROD(1
	if (!ret)
void *	xrealloc (void *ptr, size_t size) FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_ALLOC_SIZE(2) FUNC_ATTR_NONNULL_RET
void *	xmallocz (size_t size) FUNC_ATTR_MALLOC FUNC_ATTR_NONNULL_RET FUNC_ATTR_WARN_UNUSED_RESULT
void *	xmemdupz (const void *data, size_t len) FUNC_ATTR_MALLOC FUNC_ATTR_NONNULL_RET FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ALL
char *	xstrchrnul (const char *str, char c) FUNC_ATTR_NONNULL_RET FUNC_ATTR_NONNULL_ALL FUNC_ATTR_PURE
void *	xmemscan (const void *addr, char c, size_t size) FUNC_ATTR_NONNULL_RET FUNC_ATTR_NONNULL_ALL FUNC_ATTR_PURE
void	strchrsub (char *str, char c, char x) FUNC_ATTR_NONNULL_ALL
void	memchrsub (void *data, char c, char x, size_t len) FUNC_ATTR_NONNULL_ALL
size_t	strcnt (const char *str, char c) FUNC_ATTR_NONNULL_ALL FUNC_ATTR_PURE
size_t	memcnt (const void *data, char c, size_t len) FUNC_ATTR_NONNULL_ALL FUNC_ATTR_PURE
char *	xstpcpy (char *restrict dst, const char *restrict src) FUNC_ATTR_NONNULL_RET FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ALL
char *	xstpncpy (char *restrict dst, const char *restrict src, size_t maxlen) FUNC_ATTR_NONNULL_RET FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ALL
size_t	xstrlcpy (char *restrict dst, const char *restrict src, size_t dsize) FUNC_ATTR_NONNULL_ALL
size_t	xstrlcat (char *const dst, const char *const src, const size_t dsize) FUNC_ATTR_NONNULL_ALL
char *	xstrdup (const char *str) FUNC_ATTR_MALLOC FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_RET FUNC_ATTR_NONNULL_ALL
char *	xstrdupnul (const char *const str) FUNC_ATTR_MALLOC FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_RET
void *	xmemrchr (const void *src, uint8_t c, size_t len) FUNC_ATTR_NONNULL_ALL FUNC_ATTR_PURE
char *	xstrndup (const char *str, size_t len) FUNC_ATTR_MALLOC FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_RET FUNC_ATTR_NONNULL_ALL
void *	xmemdup (const void *data, size_t len) FUNC_ATTR_MALLOC FUNC_ATTR_ALLOC_SIZE(2) FUNC_ATTR_NONNULL_RET FUNC_ATTR_WARN_UNUSED_RESULT FUNC_ATTR_NONNULL_ALL
bool	strequal (const char *a, const char *b) FUNC_ATTR_PURE FUNC_ATTR_WARN_UNUSED_RESULT
	Returns true if strings a and b are equal. Arguments may be NULL. More...
bool	striequal (const char *a, const char *b) FUNC_ATTR_PURE FUNC_ATTR_WARN_UNUSED_RESULT
	Case-insensitive strequal. More...
void	do_outofmem_msg (size_t size)
void	time_to_bytes (time_t time_, uint8_t buf[8])
	Writes time_t to "buf[8]". More...

Variables
void	FUNC_ATTR_NONNULL_RET
size_t	allocated_size = count && size ? size : 1
void *	ret = calloc(allocated_count, allocated_size)

Function Documentation

do_outofmem_msg()

void do_outofmem_msg

(

size_t

size

)

if()

if

(

!

ret

)

memchrsub()

void memchrsub	(	void *	data,
		char	c,
		char	x,
		size_t	len
	)

Replaces every instance of c with x.

Parameters

data	An object in memory. May contain NULs.
c	The unwanted byte.
x	The replacement.
len	The length of data.

memcnt()

size_t memcnt	(	const void *	data,
		char	c,
		size_t	len
	)

Counts the number of occurrences of byte c in data[len].

Parameters

data	Pointer to the data to search.
c	The byte to search for.
len	The length of data.

Returns

the number of occurrences of c in data[len].

strchrsub()

void strchrsub	(	char *	str,
		char	c,
		char	x
	)

Replaces every instance of c with x.

Warning

Will read past str + strlen(str) if c == NUL.

Parameters

str	A NUL-terminated string.
c	The unwanted byte.
x	The replacement.

strcnt()

size_t strcnt	(	const char *	str,
		char	c
	)

Counts the number of occurrences of c in str.

Warning

Unsafe if c == NUL.

Parameters

str	Pointer to the string to search.
c	The byte to search for.

Returns

the number of occurrences of c in str.

strequal()

bool strequal	(	const char *	a,
		const char *	b
	)

Returns true if strings a and b are equal. Arguments may be NULL.

striequal()

bool striequal	(	const char *	a,
		const char *	b
	)

Case-insensitive strequal.

time_to_bytes()

void time_to_bytes	(	time_t	time_,
		uint8_t	buf[8]
	)

Writes time_t to "buf[8]".

try_malloc()

void* try_malloc

(

size_t

size

)

malloc() wrapper

try_malloc() is a malloc() wrapper that tries to free some memory before trying again.

See also

{try_to_free_memory}

Parameters

size

Returns

pointer to allocated space. NULL if out of memory

try_to_free_memory()

void try_to_free_memory

(

void

)

Try to free memory. Used when trying to recover from out of memory errors.

See also

{xmalloc}

verbose_try_malloc()

void* verbose_try_malloc

(

size_t

size

)

try_malloc() wrapper that shows an out-of-memory error message to the user before returning NULL

See also

{try_malloc}

Parameters

size

Returns

pointer to allocated space. NULL if out of memory

xcalloc()

void* xcalloc	(	size_t	count,
		size_t	size
	)

calloc() wrapper

See also

{xmalloc}

Parameters

count
size

Returns

pointer to allocated space. Never NULL

xfree()

void xfree

(

void *

ptr

)

free() wrapper that delegates to the backing memory manager

Note

Use XFREE_CLEAR() instead, if possible.

xmalloc()

void* xmalloc

(

size_t

size

)

malloc() wrapper that never returns NULL

xmalloc() succeeds or gracefully aborts when out of memory. Before aborting try to free some memory and call malloc again.

See also

{try_to_free_memory}

Parameters

size

Returns

pointer to allocated space. Never NULL

xmallocz()

void* xmallocz

(

size_t

size

)

xmalloc() wrapper that allocates size + 1 bytes and zeroes the last byte

Commonly used to allocate strings, e.g. char *s = xmallocz(len).

See also

{xmalloc}

Parameters

size

Returns

pointer to allocated space. Never NULL

xmemdup()

void* xmemdup	(	const void *	data,
		size_t	len
	)

Duplicates a chunk of memory using xmalloc

See also

{xmalloc}

Parameters

data	pointer to the chunk
len	size of the chunk

Returns

a pointer

xmemdupz()

void* xmemdupz	(	const void *	data,
		size_t	len
	)

Allocates (len + 1) bytes of memory, duplicates len bytes of data to the allocated memory, zero terminates the allocated memory, and returns a pointer to the allocated memory. If the allocation fails, the program dies.

See also

{xmalloc}

Parameters

data	Pointer to the data that will be copied
len	number of bytes that will be copied

xmemrchr()

void* xmemrchr	(	const void *	src,
		uint8_t	c,
		size_t	len
	)

A version of memchr that starts the search at src + len.

Based on glibc's memrchr.

Parameters

src	The source memory object.
c	The byte to search for.
len	The length of the memory object.

Returns

a pointer to the found byte in src[len], or NULL.

xmemscan()

void* xmemscan	(	const void *	addr,
		char	c,
		size_t	size
	)

A version of memchr() that returns a pointer one past the end if it doesn't find c.

Parameters

addr	The address of the memory object.
c	The char to look for.
size	The size of the memory object.

Returns

a pointer to the first instance of c, or one past the end if not found.

xrealloc()

void* xrealloc	(	void *	ptr,
		size_t	size
	)

realloc() wrapper

See also

{xmalloc}

Parameters

size

Returns

pointer to reallocated space. Never NULL

xstpcpy()

char* xstpcpy	(	char *restrict	dst,
		const char *restrict	src
	)

Copies the string pointed to by src (including the terminating NUL character) into the array pointed to by dst.

Returns

pointer to the terminating NUL char copied into the dst buffer. This is the only difference with strcpy(), which returns dst.

WARNING: If copying takes place between objects that overlap, the behavior is undefined.

Nvim version of POSIX 2008 stpcpy(3). We do not require POSIX 2008, so implement our own version.

Parameters

dst
src

xstpncpy()

char* xstpncpy	(	char *restrict	dst,
		const char *restrict	src,
		size_t	maxlen
	)

Copies not more than n bytes (bytes that follow a NUL character are not copied) from the array pointed to by src to the array pointed to by dst.

If a NUL character is written to the destination, xstpncpy() returns the address of the first such NUL character. Otherwise, it shall return &dst[maxlen].

WARNING: If copying takes place between objects that overlap, the behavior is undefined.

WARNING: xstpncpy will ALWAYS write maxlen bytes. If src is shorter than maxlen, zeroes will be written to the remaining bytes.

Parameters

dst
src
maxlen

xstrchrnul()

char* xstrchrnul	(	const char *	str,
		char	c
	)

A version of strchr() that returns a pointer to the terminating NUL if it doesn't find c.

Parameters

str	The string to search.
c	The char to look for.

Returns

a pointer to the first instance of c, or to the NUL terminator if not found.

xstrdup()

char* xstrdup

(

const char *

str

)

strdup() wrapper

See also

{xmalloc}

Parameters

str	0-terminated string that will be copied

Returns

pointer to a copy of the string

xstrdupnul()

char* xstrdupnul

(

const char *const

str

)

strdup() wrapper

Unlike xstrdup() allocates a new empty string if it receives NULL.

xstrlcat()

size_t xstrlcat	(	char *const	dst,
		const char *const	src,
		const size_t	dsize
	)

Appends src to string dst of size dsize (unlike strncat, dsize is the full size of dst, not space left). At most dsize-1 characters will be copied. Always NUL terminates. src and dst may overlap.

See also

vim_strcat from Vim.

strlcat from OpenBSD.

Parameters

[in,out]	dst	Buffer to be appended-to. Must have a NUL byte.
[in]	src	String to put at the end of dst.
[in]	dsize	Size of dst including NUL byte. Must be greater than 0.

Returns

Length of the resulting string as if destination size was #SIZE_MAX. May be greater than dsize - 1, which would mean that string was truncated.

xstrlcpy()

size_t xstrlcpy	(	char *restrict	dst,
		const char *restrict	src,
		size_t	dsize
	)

xstrlcpy - Copy a NUL-terminated string into a sized buffer

Compatible with *BSD strlcpy: the result is always a valid NUL-terminated string that fits in the buffer (unless, of course, the buffer size is zero). It does not pad out the result like strncpy() does.

Parameters

[out]	dst	Buffer to store the result.
[in]	src	String to be copied.
[in]	dsize	Size of dst.

Returns

Length of src. May be greater than dsize - 1, which would mean that string was truncated.

xstrndup()

char* xstrndup	(	const char *	str,
		size_t	len
	)

strndup() wrapper

See also

{xmalloc}

Parameters

str	0-terminated string that will be copied

Returns

pointer to a copy of the string

Variable Documentation

allocated_size

size_t allocated_size = count && size ? size : 1

FUNC_ATTR_NONNULL_RET

void FUNC_ATTR_NONNULL_RET

Initial value:

{
  size_t allocated_count = count && size ? count : 1

ret

return ret = calloc(allocated_count, allocated_size)