[ruby/strscan] Replace "iff" with "if and only if" (#18)

gmcgibbon · hsbt · commit a42b7de436cf · 2021-05-06T16:21:14.000+09:00
iff means if and only if, but readers without that knowledge might assume this to be a spelling mistake. To me, this seems like exclusionary language that is unnecessary. Simply using "if and only if" instead should suffice. ruby/strscan@066451c11e
diff --git a/ext/strscan/strscan.c b/ext/strscan/strscan.c
@@ -981,7 +981,7 @@ strscan_unscan(VALUE self)
 }
 
 /*
- * Returns +true+ iff the scan pointer is at the beginning of the line.
+ * Returns +true+ if and only if the scan pointer is at the beginning of the line.
  *
  *   s = StringScanner.new("test\ntest\n")
  *   s.bol?           # => true
@@ -1034,7 +1034,7 @@ strscan_empty_p(VALUE self)
 }
 
 /*
- * Returns true iff there is more data in the string.  See #eos?.
+ * Returns true if and only if there is more data in the string.  See #eos?.
  * This method is obsolete; use #eos? instead.
  *
  *   s = StringScanner.new('test string')
@@ -1051,7 +1051,7 @@ strscan_rest_p(VALUE self)
 }
 
 /*
- * Returns +true+ iff the last match was successful.
+ * Returns +true+ if and only if the last match was successful.
  *
  *   s = StringScanner.new('test string')
  *   s.match?(/\w+/)     # => 4

Original file line number	Diff line number	Diff line change
`@@ -981,7 +981,7 @@ strscan_unscan(VALUE self)`
`981`	`981`	`}`
`982`	`982`
`983`	`983`	`/*`
`984`		`- * Returns +true+ iff the scan pointer is at the beginning of the line.`
	`984`	`+ * Returns +true+ if and only if the scan pointer is at the beginning of the line.`
`985`	`985`	`*`
`986`	`986`	`* s = StringScanner.new("test\ntest\n")`
`987`	`987`	`* s.bol? # => true`
`@@ -1034,7 +1034,7 @@ strscan_empty_p(VALUE self)`
`1034`	`1034`	`}`
`1035`	`1035`
`1036`	`1036`	`/*`
`1037`		`- * Returns true iff there is more data in the string. See #eos?.`
	`1037`	`+ * Returns true if and only if there is more data in the string. See #eos?.`
`1038`	`1038`	`* This method is obsolete; use #eos? instead.`
`1039`	`1039`	`*`
`1040`	`1040`	`* s = StringScanner.new('test string')`
`@@ -1051,7 +1051,7 @@ strscan_rest_p(VALUE self)`
`1051`	`1051`	`}`
`1052`	`1052`
`1053`	`1053`	`/*`
`1054`		`- * Returns +true+ iff the last match was successful.`
	`1054`	`+ * Returns +true+ if and only if the last match was successful.`
`1055`	`1055`	`*`
`1056`	`1056`	`* s = StringScanner.new('test string')`
`1057`	`1057`	`* s.match?(/\w+/) # => 4`