]> git.ozlabs.org Git - ccan/blobdiff - ccan/str/_info
base64: fix for unsigned chars (e.g. ARM).
[ccan] / ccan / str / _info
index 081e862d6d69fd7109c1f45ca4733923f5d91a7e..b579525faac18e1fa52096b2e9b6eff34a70b404 100644 (file)
@@ -1,6 +1,6 @@
+#include "config.h"
 #include <stdio.h>
 #include <string.h>
-#include "config.h"
 
 /**
  * str - string helper routines
@@ -8,22 +8,35 @@
  * This is a grab bag of functions for string operations, designed to enhance
  * the standard string.h.
  *
+ * Note that if you define CCAN_STR_DEBUG, you will get extra compile
+ * checks on common misuses of the following functions (they will now
+ * be out-of-line, so there is a runtime penalty!).
+ *
+ *     strstr, strchr, strrchr:
+ *             Return const char * if first argument is const (gcc only).
+ *
+ *     isalnum, isalpha, isascii, isblank, iscntrl, isdigit, isgraph,
+ *         islower, isprint, ispunct, isspace, isupper, isxdigit:
+ *             Static and runtime check that input is EOF or an *unsigned*
+ *             char, as per C standard (really!).
+ *
  * Example:
  *     #include <stdio.h>
  *     #include <ccan/str/str.h>
  *
  *     int main(int argc, char *argv[])
  *     {
- *             if (argv[1] && streq(argv[1], "--verbose"))
+ *             if (argc > 1 && streq(argv[1], "--verbose"))
  *                     printf("verbose set\n");
- *             if (argv[1] && strstarts(argv[1], "--"))
+ *             if (argc > 1 && strstarts(argv[1], "--"))
  *                     printf("Some option set\n");
- *             if (argv[1] && strends(argv[1], "cow-powers"))
+ *             if (argc > 1 && strends(argv[1], "cow-powers"))
  *                     printf("Magic option set\n");
  *             return 0;
  *     }
  *
- * Licence: LGPL (2 or any later version)
+ * License: CC0 (Public domain)
+ * Author: Rusty Russell <rusty@rustcorp.com.au>
  */
 int main(int argc, char *argv[])
 {
@@ -31,6 +44,7 @@ int main(int argc, char *argv[])
                return 1;
 
        if (strcmp(argv[1], "depends") == 0) {
+               printf("ccan/build_assert\n");
                return 0;
        }