diff options
Diffstat (limited to '')
| -rw-r--r-- | src/lib/libc/string/strcasecmp.3 | 76 |
1 files changed, 56 insertions, 20 deletions
diff --git a/src/lib/libc/string/strcasecmp.3 b/src/lib/libc/string/strcasecmp.3 index 3870362216..bb39df895a 100644 --- a/src/lib/libc/string/strcasecmp.3 +++ b/src/lib/libc/string/strcasecmp.3 | |||
| @@ -1,7 +1,8 @@ | |||
| 1 | .\" $OpenBSD: strcasecmp.3,v 1.13 2015/11/24 09:14:35 daniel Exp $ | 1 | .\" $OpenBSD: strcasecmp.3,v 1.14 2017/09/05 03:16:13 schwarze Exp $ |
| 2 | .\" | 2 | .\" |
| 3 | .\" Copyright (c) 1990, 1991, 1993 | 3 | .\" Copyright (c) 1990, 1991, 1993 |
| 4 | .\" The Regents of the University of California. All rights reserved. | 4 | .\" The Regents of the University of California. All rights reserved. |
| 5 | .\" Copyright (c) 2017 Ingo Schwarze <schwarze@openbsd.org> | ||
| 5 | .\" | 6 | .\" |
| 6 | .\" This code is derived from software contributed to Berkeley by | 7 | .\" This code is derived from software contributed to Berkeley by |
| 7 | .\" Chris Torek. | 8 | .\" Chris Torek. |
| @@ -31,25 +32,43 @@ | |||
| 31 | .\" | 32 | .\" |
| 32 | .\" @(#)strcasecmp.3 8.1 (Berkeley) 6/9/93 | 33 | .\" @(#)strcasecmp.3 8.1 (Berkeley) 6/9/93 |
| 33 | .\" | 34 | .\" |
| 34 | .Dd $Mdocdate: November 24 2015 $ | 35 | .Dd $Mdocdate: September 5 2017 $ |
| 35 | .Dt STRCASECMP 3 | 36 | .Dt STRCASECMP 3 |
| 36 | .Os | 37 | .Os |
| 37 | .Sh NAME | 38 | .Sh NAME |
| 38 | .Nm strcasecmp , | 39 | .Nm strcasecmp , |
| 39 | .Nm strncasecmp | 40 | .Nm strcasecmp_l , |
| 41 | .Nm strncasecmp , | ||
| 42 | .Nm strncasecmp_l | ||
| 40 | .Nd compare strings, ignoring case | 43 | .Nd compare strings, ignoring case |
| 41 | .Sh SYNOPSIS | 44 | .Sh SYNOPSIS |
| 42 | .In strings.h | 45 | .In strings.h |
| 43 | .Ft int | 46 | .Ft int |
| 44 | .Fn strcasecmp "const char *s1" "const char *s2" | 47 | .Fo strcasecmp |
| 48 | .Fa "const char *s1" | ||
| 49 | .Fa "const char *s2" | ||
| 50 | .Fc | ||
| 45 | .Ft int | 51 | .Ft int |
| 46 | .Fn strncasecmp "const char *s1" "const char *s2" "size_t len" | 52 | .Fo strcasecmp_l |
| 53 | .Fa "const char *s1" | ||
| 54 | .Fa "const char *s2" | ||
| 55 | .Fa "locale_t locale" | ||
| 56 | .Fc | ||
| 57 | .Ft int | ||
| 58 | .Fo strncasecmp | ||
| 59 | .Fa "const char *s1" | ||
| 60 | .Fa "const char *s2" | ||
| 61 | .Fa "size_t len" | ||
| 62 | .Fc | ||
| 63 | .Ft int | ||
| 64 | .Fo strncasecmp_l | ||
| 65 | .Fa "const char *s1" | ||
| 66 | .Fa "const char *s2" | ||
| 67 | .Fa "size_t len" | ||
| 68 | .Fa "locale_t locale" | ||
| 69 | .Fc | ||
| 47 | .Sh DESCRIPTION | 70 | .Sh DESCRIPTION |
| 48 | The | 71 | These functions compare the NUL-terminated strings |
| 49 | .Fn strcasecmp | ||
| 50 | and | ||
| 51 | .Fn strncasecmp | ||
| 52 | functions compare the NUL-terminated strings | ||
| 53 | .Fa s1 | 72 | .Fa s1 |
| 54 | and | 73 | and |
| 55 | .Fa s2 | 74 | .Fa s2 |
| @@ -66,27 +85,44 @@ is greater than | |||
| 66 | .Ql \e0 . | 85 | .Ql \e0 . |
| 67 | .Pp | 86 | .Pp |
| 68 | .Fn strncasecmp | 87 | .Fn strncasecmp |
| 69 | compares at most | 88 | and |
| 89 | .Fn strncasecmp_l | ||
| 90 | compare at most | ||
| 70 | .Fa len | 91 | .Fa len |
| 71 | characters. | 92 | characters. |
| 93 | .Pp | ||
| 94 | On | ||
| 95 | .Ox , | ||
| 96 | these functions always use the C locale and ignore | ||
| 97 | the global locale, the thread-specific locale, and the | ||
| 98 | .Fa locale | ||
| 99 | argument. | ||
| 100 | .Sh ENVIRONMENT | ||
| 101 | On other operating systems, the behaviour of | ||
| 102 | .Fn strcasecmp | ||
| 103 | and | ||
| 104 | .Fn strncasecmp | ||
| 105 | may depend on the | ||
| 106 | .Dv LC_CTYPE | ||
| 107 | .Xr locale 1 . | ||
| 72 | .Sh SEE ALSO | 108 | .Sh SEE ALSO |
| 73 | .Xr bcmp 3 , | ||
| 74 | .Xr memcmp 3 , | ||
| 75 | .Xr strcmp 3 , | 109 | .Xr strcmp 3 , |
| 76 | .Xr strcoll 3 , | 110 | .Xr strcoll 3 , |
| 77 | .Xr strxfrm 3 , | 111 | .Xr strxfrm 3 , |
| 78 | .Xr wcscasecmp 3 | 112 | .Xr wcscasecmp 3 |
| 79 | .Sh STANDARDS | 113 | .Sh STANDARDS |
| 80 | The | 114 | These functions conform to |
| 81 | .Fn strcasecmp | ||
| 82 | and | ||
| 83 | .Fn strncasecmp | ||
| 84 | functions conform to | ||
| 85 | .St -p1003.1-2008 . | 115 | .St -p1003.1-2008 . |
| 86 | .Sh HISTORY | 116 | .Sh HISTORY |
| 87 | The | 117 | The |
| 88 | .Fn strcasecmp | 118 | .Fn strcasecmp |
| 89 | and | 119 | and |
| 90 | .Fn strncasecmp | 120 | .Fn strncasecmp |
| 91 | functions first appeared in | 121 | functions have been available since |
| 92 | .Bx 4.3 Tahoe . | 122 | .Bx 4.3 Tahoe , |
| 123 | and | ||
| 124 | .Fn strcasecmp_l | ||
| 125 | and | ||
| 126 | .Fn strncasecmp_l | ||
| 127 | since | ||
| 128 | .Ox 6.2 . | ||
