Revision: 68971
          http://sourceforge.net/p/brlcad/code/68971
Author:   brlcad
Date:     2016-10-03 07:31:27 +0000 (Mon, 03 Oct 2016)
Log Message:
-----------
clarify that empty strings are whitespace-trimmed

Modified Paths:
--------------
    brlcad/trunk/include/bu/str.h

Modified: brlcad/trunk/include/bu/str.h
===================================================================
--- brlcad/trunk/include/bu/str.h       2016-10-03 07:30:17 UTC (rev 68970)
+++ brlcad/trunk/include/bu/str.h       2016-10-03 07:31:27 UTC (rev 68971)
@@ -249,11 +249,14 @@
  * Returns truthfully if a given input string represents an
  * "affirmative string".
  *
- * Input values that are case-insensitively NULL, empty, "n", "no",
- * "false", "off", "(null)", or are 0-valued return as false.  Any
- * other input value return true.  Strings strongly indicating true
- * such as "y", "yes", "true", "on", or are 1-valued will return as 1,
- * other strings still return as true but may be greater than 1.
+ * Input values that are case-insensitively NULL, empty (i.e., ""
+ * after disregarding whitespace), "n", "no", "false", "off",
+ * "(null)", or are 0-valued return as false.  Any other input value
+ * returns true.
+ *
+ * Strings strongly indicating true such as "y", "yes", "true", "on",
+ * or are 1-valued will return as 1, other non-empty strings still
+ * return as true but may be greater than 1.
  */
 BU_EXPORT extern int bu_str_true(const char *str);
 
@@ -261,9 +264,10 @@
  * Returns truthfully if a given input string represents a
  * "negative string".
  *
- * Input values that are case-insensitively NULL, empty, "n", "no",
- * "false", "off", "(null)", or are 0-valued return as true.  Any
- * other input value returns as false.
+ * Input values that are case-insensitively NULL, empty (i.e., ""
+ * after disregarding whitespace), "n", "no", "false", "off",
+ * "(null)", or are 0-valued return as true.  Any other input value
+ * returns as false.
  */
 BU_EXPORT extern int bu_str_false(const char *str);
 

This was sent by the SourceForge.net collaborative development platform, the 
world's largest Open Source development site.


------------------------------------------------------------------------------
Check out the vibrant tech community on one of the world's most 
engaging tech sites, SlashDot.org! http://sdm.link/slashdot
_______________________________________________
BRL-CAD Source Commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/brlcad-commits

Reply via email to