nightmaremail

Unnamed repository; edit this file 'description' to name the repository.
Log | Files | Refs

case.3 (1733B)


      1 .TH case 3
      2 .SH NAME
      3 case \- convert ASCII uppercase bytes to lowercase
      4 .SH SYNTAX
      5 .B #include <case.h>
      6 
      7 void \fBcase_lowers\fP(\fIs\fR);
      8 .br
      9 void \fBcase_lowerb\fP(\fIs\fR,\fIlen\fR);
     10 
     11 int \fBcase_diffs\fP(\fIs\fR,\fIt\fR);
     12 .br
     13 int \fBcase_equals\fP(\fIs\fR,\fIt\fR);
     14 .br
     15 int \fBcase_starts\fP(\fIs\fR,\fIt\fR);
     16 
     17 int \fBcase_diffb\fP(\fIs\fR,\fIlen\fR,\fIt\fR);
     18 .br
     19 int \fBcase_startb\fP(\fIs\fR,\fIlen\fR,\fIt\fR);
     20 
     21 char *\fIs\fR;
     22 .br
     23 char *\fIt\fR;
     24 .br
     25 unsigned int \fIlen\fR;
     26 .SH DESCRIPTION
     27 .B case_lowers
     28 converts each uppercase byte in the string
     29 .I s
     30 to lowercase.
     31 .I s
     32 must be 0-terminated.
     33 
     34 .B case_lowerb
     35 converts each uppercase byte in the buffer
     36 .IR s ,
     37 of length
     38 .IR len ,
     39 to lowercase.
     40 
     41 .B case_diffs
     42 lexicographically compares lowercase versions of the strings
     43 .I s
     44 and
     45 .IR t .
     46 It returns something positive, negative, or zero
     47 when the first is larger than, smaller than, or equal to the second.
     48 .I s
     49 and
     50 .I t
     51 must be 0-terminated.
     52 
     53 .B case_equals
     54 means
     55 .BR !case_diffs .
     56 
     57 .B case_starts
     58 returns 1 if a lowercase version of
     59 .I s
     60 starts with a lowercase version of
     61 .IR t .
     62 .I s
     63 and
     64 .I t
     65 must be 0-terminated.
     66 
     67 .B case_diffb
     68 lexicographically compares lowercase versions of the buffers
     69 .I s
     70 and
     71 .IR t ,
     72 each of length
     73 .IR len .
     74 It returns something positive, negative, or zero
     75 when the first is larger than, smaller than, or equal to the second.
     76 
     77 .B case_startb
     78 returns 1 if a lowercase version of the buffer
     79 .IR s ,
     80 of length
     81 .IR len ,
     82 starts with a lowercase version of the string
     83 .IR t .
     84 .I t
     85 must be 0-terminated.
     86 
     87 The
     88 .B case
     89 routines
     90 are ASCII-specific.
     91 They are suitable for programs that handle
     92 case-independent networking protocols.
     93 
     94 All comparisons are performed on unsigned bytes.
     95 .SH "SEE ALSO"
     96 str_start(3)