.TH streqvmap 3 2024-01-05 "" "Programmer's Manual"
.\"  DO NOT EDIT THIS FILE   (streqvmap.3)
.\"
.\"  It has been AutoGen-ed
.\"  From the definitions    ./funcs.def
.\"  and the template file   agman3.tpl
.SH NAME
streqvmap - Set the character mappings for the streqv functions
.sp 1
.SH SYNOPSIS

#include <\fIyour-opts.h\fP>
.br
cc [...] -o outfile infile.c -l\fBopts\fP [...]
.sp 1
void \fBstreqvmap\fP(char \fIfrom\fP, char \fIto\fP, int \fIct\fP);
.sp 1
.SH DESCRIPTION
Set the character mapping.  If the count (\fBct\fP) is set to zero, then
the map is cleared by setting all entries in the map to their index
value.  Otherwise, the "\fBFrom\fP" character is mapped to the "\fBTo\fP"
character.  If \fBct\fP is greater than 1, then \fBFrom\fP and \fBTo\fP
are incremented and the process repeated until \fBct\fP entries have been
set. For example,
.nf
    streqvmap('a', 'A', 26);
.fi
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.
.TP
.IR from
Input character
.TP
.IR to
Mapped-to character
.TP
.IR ct
compare length
.sp 1
.SH ERRORS
none.
.SH SEE ALSO
The \fIinfo\fP documentation for the -l\fIopts\fP library.
.br
ao_string_tokenize(3), configFileLoad(3), optionFileLoad(3), optionFindNextValue(3), optionFindValue(3), optionFree(3), optionGetValue(3), optionLoadLine(3), optionMemberList(3), optionNextValue(3), optionOnlyUsage(3), optionPrintVersion(3), optionPrintVersionAndReturn(3), optionProcess(3), optionRestore(3), optionSaveFile(3), optionSaveState(3), optionUnloadNested(3), optionVersion(3), strequate(3), streqvcmp(3), strneqvcmp(3), strtransform(3),