SAS/C Library Reference, Vol. 1

memlwr -- Translate a Memory Block to Lowercase

SYNOPSIS

 #include <lcstring.h>

 void *memlwr(void *memblk, size_t n);

DESCRIPTION

memlwr scans the first n bytes of the input memory block addressed by memblk, converting uppercase characters ('A' through 'Z') to lowercase characters ('a' through 'z').

memlwr is not affected by a program's locale.

RETURN VALUE

memlwr returns a pointer to the memory block.

CAUTION

The second argument to memlwr is size_t. If a negative number is passed, massive overlaying of memory occurs.

EXAMPLE

  #include <stdio.h>
  #include <lcstring.h>

  static struct PART {
     size_t length;
     char *word;
     } sentence[] = { {  4, "THIS " },
                      {  8, "EXAMPLE " },
                      {  6, "SHOWS " },
                      {  8, "THE USE " },
                      {  7, "OF THE " },
                      {  7, "memlwr " },
                      { 11, "FUNCTION.n" } };

  #define NUM_PARTS (sizeof(sentence)/sizeof(struct PART))

  main()
  {
     int x;

     for (x = 0; x < NUM_PARTS; x++) {
        memlwr(sentence[x].word, sentence[x].length);
        fputs(sentence[x].word, stdout);
     }
     exit(0);
  }

RELATED FUNCTIONS

memupr, memxlt, strlwr