The rdownshift() function

The rdownshift() function changes all the uppercase characters within a null-terminated string to lowercase characters.

Syntax

void rdownshift(s)
   char *s;

s: A pointer to a null-terminated string.

Usage

The rdownshift() function refers to the current locale to determine uppercase and lowercase letters. For the default locale, US English, rdownshift() uses the ASCII lowercase (a-z) and uppercase (A-Z) letters.

If you use a nondefault locale, rdownshift() uses the lowercase and uppercase letters that the locale defines. For more information, see the HCL Informix GLS User's Guide.

Return codes

This sample program is in the rdownshift.ec file in the demo directory.

/*
    * rdownshift.ec *

    The following program uses rdownshift() on a string containing 
    alphanumeric and punctuation characters.
*/

#include <stdio.h>

main()
{
    static char string[] = "123ABCDEFGHIJK'.;";

    printf("RDOWNSHIFT Sample ESQL Program running.\n\n");

    printf("\tInput string...: [%s]\n", string);
    rdownshift(string);
    printf("\tAfter downshift: [%s]\n", string);

    printf("\nRDOWNSHIFT Sample Program over.\n\n");
}

Output

RDOWNSHIFT Sample ESQL Program running.

   Input string...: [123ABCDEFGHIJK'.;]
   After downshift: [123abcdefghijk'.;]

RDOWNSHIFT Sample Program over.