Chapter Contents

Previous

Next
memlwr

memlwr



Translate a Memory Block to Lowercase

Portability: SAS/C extension


SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTION
EXAMPLE
RELATED FUNCTIONS
SEE ALSO


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


SEE ALSO


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.