NAME

xt_strllower() - Copy string and convert upper case to lower

LIBRARY

#include <xtend/string.h>
-lxtend

SYNOPSIS

size_t  xt_strllower(char *dest, const char *src, size_t dest_size)

ARGUMENTS

src         Pointer to null-terminated string to be copied
dest        Pointer to a character array to receive the copy
dest_size   Size of the destination array

DESCRIPTION

xt_strllower(3) copies a string from src to dest, up to a maximum of dest_size - 1 characters. It behaves exactly like strlcpy(3), except that any upper case characters in the string are converted to lower case.

RETURN VALUES

Size of the src string. If this differs from dest_size, then we knoiw the copy is truncated.

EXAMPLES

char    src[] = "Some text",
dest    [DEST_SIZE + 1];
if ( xt_strllower(dest, src, DEST_SIZE + 1) != DEST_SIZE + 1 )


    fputs("Warning: String truncated.n", stderr);