www.LinuxHowtos.org

streqvmap

Section: Programmer's Manual (3)
Updated: 2016-10-27
Index Return to Main Contents

NAME

streqvmap - Set the character mappings for the streqv functions

SYNOPSIS

#include <your-opts.h>
cc [...] -o outfile infile.c -lopts [...]

void streqvmap(char from, char to, int ct);

DESCRIPTION

Set the character mapping. If the count (ct) is set to zero, then the map is cleared by setting all entries in the map to their index value. Otherwise, the "From" character is mapped to the "To" character. If ct is greater than 1, then From and To are incremented and the process repeated until ct entries have been set. For example,

    streqvmap('a', 'A', 26);

will alter the mapping so that all English lower case letters will map to upper case.

This function name is mapped to option_streqvmap so as to not conflict with the POSIX name space.

from: Input character
to: Mapped-to character
ct: compare length

ERRORS

none.