41.11. slapi_UTF8STRTOLOWER()

Description

This function converts a string of multiple UTF-8 upper-case characters to lower-case characters, not a single character as in slapi_UTF8TOLOWER().

Syntax

#include "slapi-plugin.h"
unsigned char *slapi_UTF8STRTOLOWER(char *s);;

Parameters

This function takes the following parameter:

s
A null-terminated UTF-8 string to be converted to lower case.
Returns

This function returns one of the following values:

  • A pointer to a null-terminated UTF-8 string whose characters are converted to lower case. Character which are not upper case are copied as-is.
  • NULL if the string is not found to be a UTF-8 string.
Memory Concerns

The output string is allocated and needs to be released when no longer needed.