buffer.c File Reference

General purpose object for storing and parsing strings. More...

#include "config.h"
#include <stdarg.h>
#include <stdbool.h>
#include <stdio.h>
#include <string.h>
#include "buffer.h"
#include "exit.h"
#include "logging2.h"
#include "memory.h"
#include "message.h"
#include "string2.h"

Include dependency graph for buffer.c:

Go to the source code of this file.

Functions
static size_t	buf_step_size (size_t size)
	Decide how much memory to allocate.
struct Buffer *	buf_init (struct Buffer *buf)
	Initialise a new Buffer.
void	buf_reset (struct Buffer *buf)
	Reset an existing Buffer.
size_t	buf_addstr_n (struct Buffer *buf, const char *s, size_t len)
	Add a string to a Buffer, expanding it if necessary.
static int	buf_vaprintf (struct Buffer *buf, const char *fmt, va_list ap)
	Format a string into a Buffer.
int	buf_printf (struct Buffer *buf, const char *fmt,...)
	Format a string overwriting a Buffer.
void	buf_fix_dptr (struct Buffer *buf)
	Move the dptr to end of the Buffer.
int	buf_add_printf (struct Buffer *buf, const char *fmt,...)
	Format a string appending a Buffer.
size_t	buf_addstr (struct Buffer *buf, const char *s)
	Add a string to a Buffer.
size_t	buf_addch (struct Buffer *buf, char c)
	Add a single character to a Buffer.
size_t	buf_insert (struct Buffer *buf, size_t offset, const char *s)
	Add a string in the middle of a buffer.
bool	buf_is_empty (const struct Buffer *buf)
	Is the Buffer empty?
struct Buffer *	buf_new (const char *str)
	Allocate a new Buffer.
void	buf_free (struct Buffer **ptr)
	Deallocates a buffer.
void	buf_alloc (struct Buffer *buf, size_t new_size)
	Make sure a buffer can store at least new_size bytes.
void	buf_dealloc (struct Buffer *buf)
	Release the memory allocated by a buffer.
size_t	buf_strcpy (struct Buffer *buf, const char *s)
	Copy a string into a Buffer.
size_t	buf_strcpy_n (struct Buffer *buf, const char *s, size_t len)
	Copy a string into a Buffer.
void	buf_dequote_comment (struct Buffer *buf)
	Un-escape characters in an email address comment.
size_t	buf_substrcpy (struct Buffer *buf, const char *beg, const char *end)
	Copy a partial string into a Buffer.
size_t	buf_len (const struct Buffer *buf)
	Calculate the length of a Buffer.
size_t	buf_concat_path (struct Buffer *buf, const char *dir, const char *fname)
	Join a directory name and a filename.
size_t	buf_concatn_path (struct Buffer *buf, const char *dir, size_t dirlen, const char *fname, size_t fnamelen)
	Join a directory name and a filename.
char *	buf_strdup (const struct Buffer *buf)
	Copy a Buffer's string.
struct Buffer *	buf_dup (const struct Buffer *buf)
	Copy a Buffer into a new allocated buffer.
size_t	buf_copy (struct Buffer *dst, const struct Buffer *src)
	Copy a Buffer's contents to another Buffer.
void	buf_seek (struct Buffer *buf, size_t offset)
	Set current read/write position to offset from beginning.
const char *	buf_find_string (const struct Buffer *buf, const char *s)
	Return a pointer to a substring found in the buffer.
const char *	buf_find_char (const struct Buffer *buf, const char c)
	Return a pointer to a char found in the buffer.
char	buf_at (const struct Buffer *buf, size_t offset)
	Return the character at the given offset.
bool	buf_str_equal (const struct Buffer *a, const struct Buffer *b)
	Return if two buffers are equal.
bool	buf_istr_equal (const struct Buffer *a, const struct Buffer *b)
	Return if two buffers are equal, case insensitive.
size_t	buf_startswith (const struct Buffer *buf, const char *prefix)
	Check whether a buffer starts with a prefix.
int	buf_coll (const struct Buffer *a, const struct Buffer *b)
	Collate two strings (compare using locale)
void	buf_lower (struct Buffer *buf)
	Sets a buffer to lowercase.
void	buf_join_str (struct Buffer *buf, const char *str, char sep)
	Join a buffer with a string separated by sep.
void	buf_inline_replace (struct Buffer *buf, size_t pos, size_t len, const char *str)
	Replace part of a string.
const char *	buf_rfind (const struct Buffer *buf, const char *str)
	Find last instance of a substring.

Detailed Description

General purpose object for storing and parsing strings.

Authors

• Ian Zimmerman
• Richard Russon
• Pietro Cerutti
• Anna Figueiredo Gomes
• Simon Reichel
• Dennis Schön

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file buffer.c.

Function Documentation

buf_step_size()

static size_t buf_step_size ( size_t size )

static

Decide how much memory to allocate.

Parameters

size	Requested memory in bytes

Return values

num	Number of bytes to actually allocate

Definition at line 54 of file buffer.c.

{
  if (size <= 16)
    return 16;
  if (size <= 32)
    return 32;
  if (size <= 64)
    return 64;
  if (size <= 128)
    return 128;
  return ROUND_UP(size, 128);
}

Here is the caller graph for this function:

buf_init()

struct Buffer * buf_init

(

struct Buffer *

buf

)

Initialise a new Buffer.

Parameters

buf	Buffer to initialise

Return values

ptr	Initialised Buffer

This must not be called on a Buffer that already contains data.

Definition at line 74 of file buffer.c.

{
  if (!buf)
    return NULL;
  memset(buf, 0, sizeof(struct Buffer));
  return buf;
}

Here is the caller graph for this function:

buf_reset()

void buf_reset

(

struct Buffer *

buf

)

Reset an existing Buffer.

Parameters

buf	Buffer to reset

This can be called on a Buffer to reset the pointers, effectively emptying it.

Definition at line 89 of file buffer.c.

{
  if (!buf || !buf->data || (buf->dsize == 0))
    return;
  memset(buf->data, 0, buf->dsize);
  buf_seek(buf, 0);
}

Here is the call graph for this function:

buf_addstr_n()

size_t buf_addstr_n	(	struct Buffer *	buf,
		const char *	s,
		size_t	len )

Add a string to a Buffer, expanding it if necessary.

Parameters

buf	Buffer to add to
s	String to add
len	Length of the string

Return values

num	Bytes written to Buffer
0	Error

Dynamically grow a Buffer to accommodate s, in increments of 128 bytes. Always one byte bigger than necessary for the NUL-terminator, and the buffer is always NUL-terminated

Definition at line 109 of file buffer.c.

{
  if (!buf || !s)
    return 0;
 
  if (!buf->data || !buf->dptr || ((buf->dptr + len + 1) > (buf->data + buf->dsize)))
  {
    buf_alloc(buf, buf->dsize + len);
  }
 
  memcpy(buf->dptr, s, len);
  buf->dptr += len;
  *(buf->dptr) = '\0';
  return len;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_vaprintf()

static int buf_vaprintf ( struct Buffer * buf, const char * fmt, va_list ap )

static

Format a string into a Buffer.

Parameters

buf	Buffer
fmt	printf-style format string
ap	Arguments to be formatted

Return values

num	Characters written
0	Error

Definition at line 133 of file buffer.c.

{
  if (!buf || !fmt)
    return 0; /* LCOV_EXCL_LINE */
 
  buf_alloc(buf, 128);
 
  size_t doff = buf->dptr - buf->data;
  size_t blen = buf->dsize - doff;
 
  va_list ap_retry = { 0 };
  va_copy(ap_retry, ap);
 
  int len = vsnprintf(buf->dptr, blen, fmt, ap);
  if (len >= (int) blen)
  {
    buf_alloc(buf, buf->dsize + len - blen + 1);
    len = vsnprintf(buf->dptr, len + 1, fmt, ap_retry);
  }
  if (len > 0)
    buf->dptr += len;
 
  va_end(ap_retry);
 
  return len;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_printf()

int buf_printf	(	struct Buffer *	buf,
		const char *	fmt,
			... )

Format a string overwriting a Buffer.

Parameters

buf	Buffer
fmt	printf-style format string
...	Arguments to be formatted

Return values

num	Characters written
-1	Error

Definition at line 168 of file buffer.c.

{
  if (!buf || !fmt)
    return -1;
 
  va_list ap = { 0 };
 
  va_start(ap, fmt);
  buf_reset(buf);
  int len = buf_vaprintf(buf, fmt, ap);
  va_end(ap);
 
  return len;
}

Here is the call graph for this function:

buf_fix_dptr()

void buf_fix_dptr

(

struct Buffer *

buf

)

Move the dptr to end of the Buffer.

Parameters

buf	Buffer to alter

Ensure buffer->dptr points to the end of the buffer.

Definition at line 189 of file buffer.c.

{
  if (!buf)
    return;
 
  buf_seek(buf, 0);
 
  if (buf->data && (buf->dsize > 0))
  {
    buf->data[buf->dsize - 1] = '\0';
    buf->dptr = strchr(buf->data, '\0');
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_add_printf()

int buf_add_printf	(	struct Buffer *	buf,
		const char *	fmt,
			... )

Format a string appending a Buffer.

Parameters

buf	Buffer
fmt	printf-style format string
...	Arguments to be formatted

Return values

num	Characters written
-1	Error

Definition at line 211 of file buffer.c.

{
  if (!buf || !fmt)
    return -1;
 
  va_list ap = { 0 };
 
  va_start(ap, fmt);
  int len = buf_vaprintf(buf, fmt, ap);
  va_end(ap);
 
  return len;
}

Here is the call graph for this function:

buf_addstr()

size_t buf_addstr	(	struct Buffer *	buf,
		const char *	s )

Add a string to a Buffer.

Parameters

buf	Buffer to add to
s	String to add

Return values

num	Bytes written to Buffer

If necessary, the Buffer will be expanded.

Definition at line 233 of file buffer.c.

{
  if (!buf || !s)
    return 0;
  return buf_addstr_n(buf, s, mutt_str_len(s));
}

Here is the call graph for this function:

buf_addch()

size_t buf_addch	(	struct Buffer *	buf,
		char	c )

Add a single character to a Buffer.

Parameters

buf	Buffer to add to
c	Character to add

Return values

num	Bytes written to Buffer

If necessary, the Buffer will be expanded.

Definition at line 248 of file buffer.c.

{
  if (!buf)
    return 0;
  return buf_addstr_n(buf, &c, 1);
}

Here is the call graph for this function:

buf_insert()

size_t buf_insert	(	struct Buffer *	buf,
		size_t	offset,
		const char *	s )

Add a string in the middle of a buffer.

Parameters

buf	Buffer
offset	Position for the insertion
s	String to insert

Return values

num	Characters written
-1	Error

Definition at line 263 of file buffer.c.

{
  if (!buf || !s || (*s == '\0'))
  {
    return -1;
  }
 
  const size_t slen = mutt_str_len(s);
  const size_t curlen = buf_len(buf);
  buf_alloc(buf, curlen + slen + 1);
 
  if (offset > curlen)
  {
    for (size_t i = curlen; i < offset; i++)
    {
      buf_addch(buf, ' ');
    }
    buf_addstr(buf, s);
  }
  else
  {
    memmove(buf->data + offset + slen, buf->data + offset, curlen - offset);
    memcpy(buf->data + offset, s, slen);
    buf->data[curlen + slen] = '\0';
    buf->dptr = buf->data + curlen + slen;
  }
 
  return buf_len(buf) - curlen;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_is_empty()

bool buf_is_empty

(

const struct Buffer *

buf

)

Is the Buffer empty?

Parameters

buf	Buffer to inspect

Return values

true	Buffer is empty

Definition at line 298 of file buffer.c.

{
  if (!buf || !buf->data)
    return true;
 
  return (buf_at(buf, 0) == '\0');
}

Here is the call graph for this function:

buf_new()

struct Buffer * buf_new

(

const char *

str

)

Allocate a new Buffer.

Parameters

str	String to initialise the buffer with, can be NULL

Return values

ptr	Pointer to new buffer

Definition at line 311 of file buffer.c.

{
  struct Buffer *buf = MUTT_MEM_CALLOC(1, struct Buffer);
 
  if (str)
    buf_addstr(buf, str);
  else
    buf_alloc(buf, 1);
  return buf;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_free()

void buf_free

(

struct Buffer **

ptr

)

Deallocates a buffer.

Parameters

ptr	Buffer to free

Definition at line 326 of file buffer.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct Buffer *buf = *ptr;
  buf_dealloc(buf);
 
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_alloc()

void buf_alloc	(	struct Buffer *	buf,
		size_t	new_size )

Make sure a buffer can store at least new_size bytes.

Parameters

buf	Buffer to change
new_size	New size

Definition at line 342 of file buffer.c.

{
  if (!buf)
    return;
 
  if (buf->data && (new_size <= buf->dsize))
  {
    // Extra sanity-checking
    if (!buf->dptr || (buf->dptr < buf->data) || (buf->dptr > (buf->data + buf->dsize)))
      buf->dptr = buf->data; // LCOV_EXCL_LINE
    return;
  }
 
  const size_t dsize = buf_step_size(new_size + 1);
  if (dsize <= new_size)
  {
    // LCOV_EXCL_START
    mutt_error(_("Out of memory"));
    mutt_exit(1);
    // LCOV_EXCL_STOP
  }
 
  const bool was_empty = (buf->dptr == NULL);
  const size_t offset = (buf->dptr && buf->data) ? (buf->dptr - buf->data) : 0;
 
  buf->dsize = dsize;
 
  MUTT_MEM_REALLOC(&buf->data, buf->dsize, char);
  buf->dptr = buf->data + offset;
 
  // Ensures that initially NULL buf->data is properly terminated
  if (was_empty)
  {
    *buf->dptr = '\0';
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_dealloc()

void buf_dealloc

(

struct Buffer *

buf

)

Release the memory allocated by a buffer.

Parameters

buf	Buffer to change

Definition at line 383 of file buffer.c.

{
  if (!buf || !buf->data)
    return;
 
  buf->dptr = NULL;
  buf->dsize = 0;
  FREE(&buf->data);
}

Here is the caller graph for this function:

buf_strcpy()

size_t buf_strcpy	(	struct Buffer *	buf,
		const char *	s )

Copy a string into a Buffer.

Parameters

buf	Buffer to overwrite
s	String to copy

Return values

num	Bytes written to Buffer

Overwrites any existing content.

Definition at line 401 of file buffer.c.

{
  if (!buf)
    return 0;
 
  buf_reset(buf);
  if (!s)
    return 0;
 
  return buf_addstr(buf, s);
}

Here is the call graph for this function:

buf_strcpy_n()

size_t buf_strcpy_n	(	struct Buffer *	buf,
		const char *	s,
		size_t	len )

Copy a string into a Buffer.

Parameters

buf	Buffer to overwrite
s	String to copy
len	Length of string to copy

Return values

num	Bytes written to Buffer

Overwrites any existing content.

Definition at line 422 of file buffer.c.

{
  if (!buf)
    return 0;
 
  buf_reset(buf);
  if (!s)
    return 0;
 
  return buf_addstr_n(buf, s, len);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_dequote_comment()

void buf_dequote_comment

(

struct Buffer *

buf

)

Un-escape characters in an email address comment.

Parameters

buf	Buffer to be un-escaped

Note

the buffer is modified

Definition at line 440 of file buffer.c.

{
  if (!buf || !buf->data || (buf->dsize == 0))
    return;
 
  buf_seek(buf, 0);
 
  char *s = buf->data;
  for (; *buf->dptr; buf->dptr++)
  {
    if (*buf->dptr == '\\')
    {
      if (!*++buf->dptr)
        break; /* error? */
      *s++ = *buf->dptr;
    }
    else if (*buf->dptr != '\"')
    {
      if (s != buf->dptr)
        *s = *buf->dptr;
      s++;
    }
  }
  *s = '\0';
 
  buf_fix_dptr(buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_substrcpy()

size_t buf_substrcpy	(	struct Buffer *	buf,
		const char *	beg,
		const char *	end )

Copy a partial string into a Buffer.

Parameters

buf	Buffer to overwrite
beg	Start of string to copy
end	End of string to copy

Return values

num	Bytes written to Buffer

Overwrites any existing content.

Definition at line 477 of file buffer.c.

{
  if (!buf)
    return 0;
 
  buf_reset(buf);
  if (!beg || !end)
    return 0;
 
  if (end <= beg)
    return 0;
 
  return buf_strcpy_n(buf, beg, end - beg);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_len()

size_t buf_len

(

const struct Buffer *

buf

)

Calculate the length of a Buffer.

Parameters

buf

Buffer

Return values

num	Size of buffer

Definition at line 497 of file buffer.c.

{
  if (!buf || !buf->data || !buf->dptr)
    return 0;
 
  return buf->dptr - buf->data;
}

Here is the caller graph for this function:

buf_concat_path()

size_t buf_concat_path	(	struct Buffer *	buf,
		const char *	dir,
		const char *	fname )

Join a directory name and a filename.

Parameters

buf	Buffer to add to
dir	Directory name
fname	File name

Return values

num	Bytes written to Buffer

If both dir and fname are supplied, they are separated with '/'. If either is missing, then the other will be copied exactly.

Definition at line 515 of file buffer.c.

{
  if (!buf)
    return 0;
 
  if (!dir)
    dir = "";
  if (!fname)
    fname = "";
 
  const bool d_set = (dir[0] != '\0');
  const bool f_set = (fname[0] != '\0');
  if (!d_set && !f_set)
    return 0;
 
  const size_t d_len = strlen(dir);
  const bool slash = d_set && (dir[d_len - 1] == '/');
 
  const char *fmt = "%s/%s";
  if (!f_set || !d_set || slash)
    fmt = "%s%s";
 
  return buf_printf(buf, fmt, dir, fname);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_concatn_path()

size_t buf_concatn_path	(	struct Buffer *	buf,
		const char *	dir,
		size_t	dirlen,
		const char *	fname,
		size_t	fnamelen )

Join a directory name and a filename.

Parameters

buf	Buffer for the result
dir	Directory name
dirlen	Directory name
fname	File name
fnamelen	File name

Return values

num	Size of buffer

If both dir and fname are supplied, they are separated with '/'. If either is missing, then the other will be copied exactly.

Definition at line 552 of file buffer.c.

{
  if (!buf)
    return 0;
 
  buf_reset(buf);
 
  size_t len = 0;
  if (dirlen != 0)
    len += buf_addstr_n(buf, dir, dirlen);
  if ((dirlen != 0) && (fnamelen != 0))
    len += buf_addch(buf, '/');
  if (fnamelen != 0)
    len += buf_addstr_n(buf, fname, fnamelen);
  return len;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_strdup()

char * buf_strdup

(

const struct Buffer *

buf

)

Copy a Buffer's string.

Parameters

buf	Buffer to copy

Return values

ptr	Copy of string

Note

Caller must free the returned string

Definition at line 577 of file buffer.c.

{
  if (!buf)
    return NULL;
 
  return mutt_str_dup(buf->data);
}

Here is the call graph for this function:

buf_dup()

struct Buffer * buf_dup

(

const struct Buffer *

buf

)

Copy a Buffer into a new allocated buffer.

Parameters

buf	Buffer to copy

Return values

buf	New allocated copy of buffer

Note

Caller must free the returned buffer

Definition at line 592 of file buffer.c.

{
  if (!buf)
    return NULL;
 
  return buf_new(buf_string(buf));
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_copy()

size_t buf_copy	(	struct Buffer *	dst,
		const struct Buffer *	src )

Copy a Buffer's contents to another Buffer.

Parameters

dst	Buffer for result
src	Buffer to copy

Return values

num	Bytes written to Buffer
0	Error

Definition at line 607 of file buffer.c.

{
  if (!dst)
    return 0;
 
  buf_reset(dst);
  if (!src || !src->data)
    return 0;
 
  return buf_addstr_n(dst, src->data, buf_len(src));
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_seek()

void buf_seek	(	struct Buffer *	buf,
		size_t	offset )

Set current read/write position to offset from beginning.

Parameters

buf	Buffer to use
offset	Distance from the beginning

This is used for cases where the buffer is read from A value is placed in the buffer, and then b->dptr is set back to the beginning as a read marker instead of write marker.

Definition at line 628 of file buffer.c.

{
  if (!buf || !buf->data)
    return;
 
  if (offset < buf->dsize)
    buf->dptr = buf->data + offset;
}

Here is the caller graph for this function:

buf_find_string()

const char * buf_find_string	(	const struct Buffer *	buf,
		const char *	s )

Return a pointer to a substring found in the buffer.

Parameters

buf	Buffer to search
s	Substring to find

Return values

NULL	substring not found
n	Pointer to the beginning of the found substring

Definition at line 644 of file buffer.c.

{
  if (!buf || !buf->data || !s)
    return NULL;
 
  return strstr(buf->data, s);
}

Here is the caller graph for this function:

buf_find_char()

const char * buf_find_char	(	const struct Buffer *	buf,
		const char	c )

Return a pointer to a char found in the buffer.

Parameters

buf	Buffer to search
c	Char to find

Return values

NULL	char not found
ptr	Pointer to the found char

Definition at line 659 of file buffer.c.

{
  if (!buf || !buf->data)
    return NULL;
 
  return strchr(buf->data, c);
}

Here is the caller graph for this function:

buf_at()

char buf_at	(	const struct Buffer *	buf,
		size_t	offset )

Return the character at the given offset.

Parameters

buf	Buffer to search
offset	Offset to get

Return values

NUL	Offset out of bounds

Returns

n The char at the offset

Definition at line 674 of file buffer.c.

{
  if (!buf || !buf->data || (offset > buf_len(buf)))
    return '\0';
 
  return buf->data[offset];
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_str_equal()

bool buf_str_equal	(	const struct Buffer *	a,
		const struct Buffer *	b )

Return if two buffers are equal.

Parameters

a	- Buffer to compare
b	- Buffer to compare

Return values

true	Strings are equal
false	String are not equal

Definition at line 689 of file buffer.c.

{
  return mutt_str_equal(buf_string(a), buf_string(b));
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_istr_equal()

bool buf_istr_equal	(	const struct Buffer *	a,
		const struct Buffer *	b )

Return if two buffers are equal, case insensitive.

Parameters

a	- First buffer to compare
b	- Second buffer to compare

Return values

true	Strings are equal
false	String are not equal

Definition at line 701 of file buffer.c.

{
  return mutt_istr_equal(buf_string(a), buf_string(b));
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_startswith()

size_t buf_startswith	(	const struct Buffer *	buf,
		const char *	prefix )

Check whether a buffer starts with a prefix.

Parameters

buf	Buffer to check
prefix	Prefix to match

Return values

num	Length of prefix if str starts with prefix
0	str does not start with prefix

Definition at line 713 of file buffer.c.

{
  if (!buf || !prefix)
    return 0;
 
  return mutt_str_startswith(buf_string(buf), prefix);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_coll()

int buf_coll	(	const struct Buffer *	a,
		const struct Buffer *	b )

Collate two strings (compare using locale)

Parameters

a	First buffer to compare
b	Second buffer to compare

Return values

<0	a precedes b
0	a and b are identical
>0	b precedes a

Definition at line 729 of file buffer.c.

{
  return mutt_str_coll(buf_string(a), buf_string(b));
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_lower()

void buf_lower

(

struct Buffer *

buf

)

Sets a buffer to lowercase.

Parameters

[out]

buf

Buffer to transform to lowercase

Note

Modifies the buffer

Definition at line 740 of file buffer.c.

{
  if (!buf || !buf->data)
    return;
 
  mutt_str_lower(buf->data);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_join_str()

void buf_join_str	(	struct Buffer *	buf,
		const char *	str,
		char	sep )

Join a buffer with a string separated by sep.

Parameters

buf	Buffer to append to
str	String to append
sep	separator between string item

Definition at line 754 of file buffer.c.

{
  if (!buf || !str)
    return;
 
  if (!buf_is_empty(buf) && mutt_str_len(str))
    buf_addch(buf, sep);
 
  buf_addstr(buf, str);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_inline_replace()

void buf_inline_replace	(	struct Buffer *	buf,
		size_t	pos,
		size_t	len,
		const char *	str )

Replace part of a string.

Parameters

buf	Buffer to modify
pos	Starting position of string to overwrite
len	Length of string to overwrite
str	Replacement string

String (11XXXOOOOOO, 2, 3, YYYY) becomes 11YYYY000000

Definition at line 774 of file buffer.c.

{
  if (!buf || !buf->data || !str)
    return;
 
  size_t slen = buf_len(buf);
  if (pos > slen)
    return;
  if (len > slen - pos)
    len = slen - pos;
 
  size_t rlen = mutt_str_len(str);
  size_t new_size = slen - len + rlen + 1;
  if (new_size > buf->dsize)
    buf_alloc(buf, new_size);
 
  memmove(buf->data + pos + rlen, buf->data + pos + len, slen - pos - len + 1);
  memcpy(buf->data + pos, str, rlen);
 
  buf_fix_dptr(buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_rfind()

const char * buf_rfind	(	const struct Buffer *	buf,
		const char *	str )

Find last instance of a substring.

Parameters

buf	Buffer to search through
str	String to find

Return values

NULL	String not found
ptr	Location of string

Return the last instance of str in the buffer, or NULL.

Definition at line 805 of file buffer.c.

{
  if (buf_is_empty(buf) || !str || (*str == '\0'))
    return NULL;
 
  size_t len = strlen(str);
  size_t slen = buf_len(buf);
  if (len > slen)
    return NULL;
 
  const char *end = buf->data + slen - len;
 
  for (const char *p = end; p >= buf->data; p--)
  {
    for (size_t i = 0; i < len; i++)
    {
      if (p[i] != str[i])
        goto next;
    }
    return p;
 
  next:;
  }
  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function: