<div dir="ltr">I am still curious why the SE-0104 FixedWidthInteger protocol uses member functions like “.xor” rather than operators for bitwise manipulation.<div><br></div><div>Nevin</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jul 1, 2016 at 8:19 PM, Dave Abrahams via swift-evolution <span dir="ltr">&lt;<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>&gt;</span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><br>
on Fri Jul 01 2016, Riley Testut &lt;<a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a>&gt; wrote:<br>
<br>
&gt; Hi all,<br>
&gt;<br>
&gt; This is probably very minor, but I’m not sure the protocol name<br>
&gt; “BitwiseOperations” fits the Swift API Design Guidelines. Here’s what<br>
&gt; the guidelines have to say about protocol names:<br>
&gt;<br>
&gt; Protocols that describe what something is should read as nouns (e.g. Collection).<br>
&gt;<br>
&gt; Protocols that describe a capability should be named using the<br>
&gt; suffixes able, ible, or ing (e.g. Equatable, ProgressReporting).<br>
&gt;<br>
&gt; From these two, BitwiseOperations appears to be (attempting) to follow<br>
&gt; the first rule, yet “BitwiseOperations” doesn’t really describe what<br>
&gt; the type is, but rather that it can do bitwise operations. The<br>
&gt; documentation itself even describes the protocol as “a type that<br>
&gt; supports standard bitwise arithmetic operators.&quot;<br>
&gt;<br>
&gt; I propose we rename it to “BitwiseOperable”, or something<br>
&gt; similar. Again, a small change, but if this were to ever happen, I<br>
&gt; think Swift 3 is the time.<br>
<br>
</span>BitwiseOperations should really be retired after<br>
<a href="https://github.com/apple/swift-evolution/blob/master/proposals/0104-improved-integers.md" rel="noreferrer" target="_blank">https://github.com/apple/swift-evolution/blob/master/proposals/0104-improved-integers.md</a><br>
is implemented, and its uses replaced by FixedWidthInteger.<br>
<span class="HOEnZb"><font color="#888888"><br>
--<br>
Dave<br>
<br>
_______________________________________________<br>
swift-evolution mailing list<br>
<a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a><br>
<a href="https://lists.swift.org/mailman/listinfo/swift-evolution" rel="noreferrer" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br>
</font></span></blockquote></div><br></div>