mdw@git.distorted.org.uk Git - qmail/blob - case.3

   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 byte_diff(3),
  97 byte_equal(3),
  98 str_diff(3),
  99 str_equal(3),
 100 str_start(3)