NAME

xt_strlower() - Convert all upper case characters to lower

LIBRARY

#include <xtend/string.h>
-lxtend

SYNOPSIS

size_t  xt_strlower(char *str)

ARGUMENTS

str         Pointer to null-terminated string to be copied

DESCRIPTION

xt_strlower(3) converts upper case characters in a string to lower case, overwriting the original. It is functionally equivalent to xt_strllower(str, str, strlen(str)). It is implemented separately for efficiency, since using xt_strllower(3) for this purpose requires knowing or computing the length of the string and passing three arguments instead of one.

RETURN VALUES

Size of the src string.

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);