strings.c File Reference

String utilities. More...

#include "strings.h"
#include <assert.h>
#include <glib.h>

Include dependency graph for strings.c:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	G_LOG_DOMAIN   "libgvm base"
	GLib log domain.

Functions
void	gvm_append_string (gchar **var, const gchar *string)
	Append a string to a string variable.
void	gvm_append_text (gchar **var, const gchar *string, gsize length)
	Append a string of a known length to a string variable.
void	gvm_free_string_var (gchar **var)
	Free a string variable.
char *	gvm_strip_space (char *string, char *end)
	"Strip" space and newline characters from either end of some memory.

Detailed Description

String utilities.

Definition in file strings.c.

Macro Definition Documentation

G_LOG_DOMAIN

#define G_LOG_DOMAIN   "libgvm base"

GLib log domain.

Definition at line 20 of file strings.c.

Function Documentation

gvm_append_string()

void gvm_append_string	(	gchar **	var,
		const gchar *	string )

Append a string to a string variable.

When the variable is NULL store a copy of the given string in the variable.

When the variable already contains a string replace the string with a new string that is the concatenation of the two, freeing the old string. It is up to the caller to free the given string if it was dynamically allocated.

Parameters

[in]	var	The address of a string variable, that is, a pointer to a string.
[in]	string	The string to append to the string in the variable.

Definition at line 36 of file strings.c.

{
  if (*var)
    {
      char *old = *var;
      *var = g_strconcat (old, string, NULL);
      g_free (old);
    }
  else
    *var = g_strdup (string);
}

Referenced by Ensure(), Ensure(), and Ensure().

Here is the caller graph for this function:

gvm_append_text()

void gvm_append_text	(	gchar **	var,
		const gchar *	string,
		gsize	length )

Append a string of a known length to a string variable.

When the variable is NULL store a copy of the given string in the variable.

When the variable already contains a string replace the string with a new string that is the concatenation of the two, freeing the old string. It is up to the caller to free the given string if it was dynamically allocated.

The string must be NULL terminated, and the given length must be the actual length of the string.

Parameters

[in]	var	The address of a string variable, that is, a pointer to a string.
[in]	string	The string to append to the string in the variable.
[in]	length	The length of string.

Definition at line 66 of file strings.c.

{
  if (*var)
    {
      char *old = *var;
      *var = g_strconcat (old, string, NULL);
      g_free (old);
    }
  else
    *var = g_strndup (string, length);
}

Referenced by append_to_credentials_password(), append_to_credentials_username(), Ensure(), Ensure(), Ensure(), and Ensure().

Here is the caller graph for this function:

gvm_free_string_var()

void gvm_free_string_var

(

gchar **

var

)

Free a string variable.

Free the string in the variable and set the variable to NULL.

Parameters

[in]

var

The address of a string variable, that is, a pointer to a string.

Definition at line 87 of file strings.c.

{
  g_free (*var);
  *var = NULL;
}

Referenced by Ensure(), and Ensure().

Here is the caller graph for this function:

gvm_strip_space()

char * gvm_strip_space	(	char *	string,
		char *	end )

"Strip" space and newline characters from either end of some memory.

Return the given pointer moved forward past any spaces, replacing the first of any contiguous spaces at or before the end of the memory with a terminating NULL.

This is for use when string points into a static buffers.

Parameters

[in,out]	string	The start of the memory.
[in]	end	Pointer to the byte after the end of the memory.

Returns

A new pointer into the string.

Definition at line 108 of file strings.c.

{
  assert (string <= end);
  if (string >= end)
    return string;
  end--;
  while (string[0] == ' ' || string[0] == '\n')
    {
      string++;
      if (string >= end)
        {
          end[0] = '\0';
          return end;
        }
    }
 
  /* Here string is < end. */
  if (end[0] == ' ' || end[0] == '\n')
    {
      end--;
      while (end >= string && (end[0] == ' ' || end[0] == '\n'))
        {
          end--;
        }
      end[1] = '\0';
    }
  return string;
}

Referenced by Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), Ensure(), and Ensure().

Here is the caller graph for this function: