1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62
|
.\"(c) Copyright 1992, 1993 by Panagiotis Tsirigotis
.\"All rights reserved. The file named COPYRIGHT specifies the terms
.\"and conditions for redistribution.
.\"
.\" $Id$
.TH STRUTIL 3X "30 September 1992"
.SH NAME
str_find, str_casefind, str_fill, str_lower, str_upper -- string utility functions
.SH SYNOPSIS
.LP
.nf
.ft B
#include "str.h"
.LP
.ft B
char *str_find( s1, s2 )
char *s1, *s2 ;
.LP
.ft B
char *str_casefind( s1, s2 )
char *s1, *s2 ;
.LP
.ft B
void str_fill( s, c )
char *s ;
char c ;
.LP
.ft B
char *str_lower( s )
char *s ;
.LP
.ft B
char *str_upper( s )
char *s ;
.SH DESCRIPTION
.B str_find()
returns a pointer to the first instance of string \fIs2\fR in string \fIs1\fR.
If \fIs2\fR is the empty string a pointer to \fIs1\fR is returned.
.LP
.B str_casefind()
performs the same function as
.B str_find()
except that it performs case insensitive character comparisons.
.LP
.B str_fill()
fills the string \fIs\fR with the character \fIc\fR.
.LP
.B str_lower()
and
.B str_upper()
convert their argument in place to a lower or upper case string respectively.
.SH "RETURN VALUES"
.LP
\fBstr_find()\fR
and
.B str_casefind()
return a pointer to the first occurrence of \fIs2\fR
in \fIs1\fR or
.SM NULL
if \fIs2\fR does not exist in \fIs1\fR.
.LP
\fBstr_lower()\fR and \fBstr_upper()\fR return \fIs\fR.
|