cp_str.c File Reference

Implementation of string manipulation functions. More...

#include "mdb.h"

Go to the source code of this file.

Functions
char *	cp_str (char **s, char *t)
	Copies a string, allocating memory for storage.
char *	cpn_str (char **s, char *t, long n)
	Copies a specified number of characters from a string.

Detailed Description

Implementation of string manipulation functions.

Copyright

• (c) 2002 The University of Chicago, as Operator of Argonne National Laboratory.
• (c) 2002 The Regents of the University of California, as Operator of Los Alamos National Laboratory.

License

This file is distributed under the terms of the Software License Agreement found in the file LICENSE included with this distribution.

Author

M. Borland, C. Saunders, R. Soliday

Definition in file cp_str.c.

Function Documentation

cp_str()

char * cp_str	(	char **	s,
		char *	t )

Copies a string, allocating memory for storage.

This function duplicates the input string t by allocating sufficient memory and copying its contents. If t is NULL, the destination pointer s is set to NULL.

Parameters

s	Pointer to the destination string pointer.
t	Source string to be copied.

Returns

The copied string, or NULL if t is NULL.

Definition at line 28 of file cp_str.c.

                                {
  if (t == NULL)
    *s = NULL;
  else {
    *s = tmalloc(sizeof(*t) * (strlen(t) + 1));
    strcpy_ss(*s, t);
  }
  return (*s);
}

cpn_str()

char * cpn_str	(	char **	s,
		char *	t,
		long	n )

Copies a specified number of characters from a string.

This function duplicates the first n characters of the input string t by allocating sufficient memory and copying the specified number of characters. The copied string is null-terminated. If t is NULL, the destination pointer s is set to NULL.

Parameters

s	Pointer to the destination string pointer.
t	Source string from which to copy characters.
n	Number of characters to copy.

Returns

The copied string with up to n characters, or NULL if t is NULL.

Definition at line 50 of file cp_str.c.

                                         {
  if (t == NULL)
    *s = NULL;
  else {
    *s = tmalloc(sizeof(*t) * (n + 1));
    strncpy(*s, t, n);
    (*s)[n] = 0;
  }
  return (*s);
}