]> sjero.net Git - wget/blobdiff - lib/c-ctype.h
Minor msgid fixes. Typos, and corrected contact mail.
[wget] / lib / c-ctype.h
index b26eccfb3d1df818013f7b62562cc20a393f9798..d78dd19d5dc9a18fbde4533e1a362ffc3af743cc 100644 (file)
@@ -5,11 +5,11 @@
    <ctype.h> functions' behaviour depends on the current locale set via
    setlocale.
 
    <ctype.h> functions' behaviour depends on the current locale set via
    setlocale.
 
-   Copyright (C) 2000-2003, 2006 Free Software Foundation, Inc.
+   Copyright (C) 2000-2003, 2006, 2008 Free Software Foundation, Inc.
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
 
 This program is free software; you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
-the Free Software Foundation; either version 2 of the License, or
+the Free Software Foundation; either version 3 of the License, or
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
 (at your option) any later version.
 
 This program is distributed in the hope that it will be useful,
@@ -103,6 +103,21 @@ extern "C" {
 
 /* Function declarations. */
 
 
 /* Function declarations. */
 
+/* Unlike the functions in <ctype.h>, which require an argument in the range
+   of the 'unsigned char' type, the functions here operate on values that are
+   in the 'unsigned char' range or in the 'char' range.  In other words,
+   when you have a 'char' value, you need to cast it before using it as
+   argument to a <ctype.h> function:
+
+         const char *s = ...;
+         if (isalpha ((unsigned char) *s)) ...
+
+   but you don't need to cast it for the functions defined in this file:
+
+         const char *s = ...;
+         if (c_isalpha (*s)) ...
+ */
+
 extern bool c_isascii (int c); /* not locale dependent */
 
 extern bool c_isalnum (int c);
 extern bool c_isascii (int c); /* not locale dependent */
 
 extern bool c_isalnum (int c);