Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
xt_strupper(3)		    Library Functions Manual		  xt_strupper(3)

NAME
     xt_strupper() - Covert all lower case characters to upper

LIBRARY
     #include <xtend/string.h>
     -lxtend

SYNOPSIS
     size_t  xt_strupper(char *str)

ARGUMENTS
     str	 Pointer to null-terminated string to be copied

DESCRIPTION
     xt_strupper(3)  converts  lower  case characters in a string to upper case,
     overwriting the original.	It  is	functionally  equivalent  to  xt_strlup-
     per(str,  str,  strlen(str)).  It is implemented separately for efficiency,
     since using xt_strlupper(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_strlupper(dest, src, DEST_SIZE + 1) != DEST_SIZE + 1 )
	 fputs("Warning: String truncated.n", stderr);

SEE ALSO
     xt_strllower(3), strlcpy(3), strlcat(3)

								  xt_strupper(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xt_strupper&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help