zeString.c

Go to the documentation of this file.

/*
 *
 * ze-filter - Mail Server Filter for sendmail
 *
 * Copyright (c) 2001-2018 - Jose-Marcio Martins da Cruz
 *
 *  Auteur       : Jose Marcio Martins da Cruz
 *                 jose.marcio.mc@gmail.com
 *
 *  Historique   :
 *  Creation     : Wed Nov 29 10:19:07 CET 2017
 *
 * This program is free software - GPL v2., 
 *
 * 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.
 *
 */

/*
 * Copyright (c) 1999-2002, 2004, 2005 Sendmail, Inc. and its suppliers.
 *  All rights reserved.
 *
 * By using this file, you agree to the terms and conditions set
 * forth in the LICENSE file which can be found at the top level of
 * the sendmail distribution.
 *
 */

#include <ze-sys.h>
#include <libze.h>
#include <zeString.h>

/* ****************************************************************************
 *                                                                            *
 *                                                                            *
 **************************************************************************** */

/*
**  STRLCAT -- size bounded string concatenation
**
**  This is a bounds-checking variant of strcat.
**  If strlen(dst) < size, then append at most size - strlen(dst) - 1
**  characters from the source string to the destination string,
**  nul terminating the result.  Otherwise, dst is not modified.
**
**  The result is the initial length of dst + the length of src.
**  You can detect overflow (not all of the characters in the
**  source string were copied) using the following idiom:
**
**    char *s, buf[BUFSIZ];
**    ...
**    if (strlcat(buf, s, sizeof(buf)) >= sizeof(buf))
**      goto overflow;
**
**  Parameters:
**    dst -- nul-terminated destination string buffer
**    src -- nul-terminated source string
**    size -- size of destination buffer
**
**  Returns:
**    total length of the string tried to create
**    (= initial length of dst + length of src)
*/

size_t
zeStrlCat(char *dst, const char *src, size_t size)
{
  size_t              i, j, o;

  o = strlen(dst);
  if (size < o + 1)
    return o + strlen(src);
  size -= o + 1;
  for (i = 0, j = o; i < size && (dst[j] = src[i]) != 0; i++, j++)
    continue;
  dst[j] = '\0';
  if (src[i] == '\0')
    return j;
  else
    return j + strlen(src + i);
}

/*
**  STRLCPY -- size bounded string copy
**
**  This is a bounds-checking variant of strcpy.
**  If size > 0, copy up to size-1 characters from the nul terminated
**  string src to dst, nul terminating the result.  If size == 0,
**  the dst buffer is not modified.
**  Additional note: this function has been "tuned" to run fast and tested
**  as such (versus versions in some OS's libc).
**
**  The result is strlen(src).  You can detect truncation (not all
**  of the characters in the source string were copied) using the
**  following idiom:
**
**    char *s, buf[BUFSIZ];
**    ...
**    if (strlcpy(buf, s, sizeof(buf)) >= sizeof(buf))
**      goto overflow;
**
**  Parameters:
**    dst -- destination buffer
**    src -- source string
**    size -- size of destination buffer
**
**  Returns:
**    strlen(src)
*/

size_t
zeStrlCpy(char *dst, const char *src, size_t size)
{
  size_t              i;

  if (size-- <= 0)
    return strlen(src);
  for (i = 0; i < size && (dst[i] = src[i]) != 0; i++)
    continue;
  dst[i] = '\0';
  if (src[i] == '\0')
    return i;
  else
    return i + strlen(src + i);
}