<div dir="ltr">no<div><br></div><div>-1 </div><div><br></div><div>I agree that the names of these methods are inconsistent in the abstract but they are established terms of art, in my opinion. </div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jun 16, 2016 at 1:38 PM, David Waite via swift-evolution <span dir="ltr"><<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word">-1, for the same reasons stated on the thread. These are neither guaranteed to be mutating or non-mutating until you get to Collection.<div><br></div><div>Changing map() to mapped() would be lying to the developer some of the time about the mutability of the interface.</div><div><div><br></div><div>-DW<div><div class="h5"><br><div><br><div><blockquote type="cite"><div>On Jun 16, 2016, at 1:53 PM, Adrian Zubarev via swift-evolution <<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>> wrote:</div><br><div><div style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><p style="margin:15px 0px">+1 very much for consistency.<span> </span></p><div style="margin:15px 0px"><br></div></div><div style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><div style="font-family:Helvetica,Arial;font-size:13px;margin:0px"><br></div><br><div><div style="font-family:helvetica,arial;font-size:13px">-- <br>Adrian Zubarev<br>Sent with Airmail</div></div><br><p style="margin:15px 0px">Am 16. Juni 2016 um 21:51:48, Patrick Pijnappel via swift-evolution (<a href="mailto:swift-evolution@swift.org" style="color:rgb(65,131,196);background-color:inherit;text-decoration:none" target="_blank">swift-evolution@swift.org</a>) schrieb:</p><blockquote type="cite" style="margin:15px 0px"><span style="margin-top:0px;margin-bottom:0px"><div><div></div><div><div dir="ltr"><div>Due to considerably support on<span> </span><a href="http://news.gmane.org/find-root.php?group=gmane.comp.lang.swift.evolution&article=20783" style="color:rgb(65,131,196);background-color:inherit;text-decoration:none" target="_blank">this thread</a>, a draft proposal to revisit the core functional method exceptions to the -ed/-ing rule.</div><div><br></div>Online version: <a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md" style="color:rgb(65,131,196);background-color:inherit;text-decoration:none" target="_blank">https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md</a><div><br></div><div><h1 style="font-weight:bold;color:rgb(51,51,51);font-size:2.25em;margin-right:0px;margin-bottom:16px;margin-left:0px;line-height:1.2;padding-bottom:0.3em;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';margin-top:0px!important">Apply -ed/-ing rule to core functional methods</h1><ul style="margin:0px 0px 16px;padding-left:2em;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px"><li style="margin:15px 0px">Proposal: <a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/NNNN-functional-methods-ed-ing.md" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none" target="_blank">SE-NNNN</a></li><li style="margin:15px 0px">Author: <a href="https://github.com/PatrickPijnappel" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none" target="_blank">Patrick Pijnappel</a></li><li style="margin:15px 0px">Status: <span>Awaiting review</span></li><li style="margin:15px 0px">Review manager: TBD</li></ul><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#introduction" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Introduction</h2><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">The Swift API Guidelines standardizes non-mutating method forms on verbs ending in -ed/-ing (or nouns). However, a few non-mutating forms have been kept as "Terms of Art": <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">map</code>, <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">flatMap</code>, <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">filter</code>, <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">reduce</code>, <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">dropFirst</code> and <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">dropLast</code>. This proposal proposes to bring these in line with all other non-mutating forms (e.g. <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">filter => filtered</code>).</p><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">Swift-evolution threads: <a href="http://news.gmane.org/find-root.php?group=gmane.comp.lang.swift.evolution&article=20783" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none" target="_blank">Source</a></p><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#motivation" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Motivation</h2><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">These method have been kept to preserve the terms of art. Generally, this can have significant benefits:</p><ul style="margin:0px 0px 16px;padding-left:2em;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px"><li style="margin:15px 0px">Anyone familiar with the term will immediately understand it, and use their assumptions about how it works.</li><li style="margin:15px 0px">Users learning the term from Swift can use their knowledge when encountering it elsewhere.</li><li style="margin:15px 0px">Experienced users will be able to use the mental pattern matching they've built-up for quickly recognizing common programming patterns.</li></ul><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">However, basically all of the benefits of using a term of art still apply to the modified forms: – For recognition, the modified forms are still very close to the traditional terms of art. So both coming to and from Swift you'll be able to use your knowledge pretty much unaffected. </p><ul style="margin:0px 0px 16px;padding-left:2em;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px"><li style="margin:15px 0px">If the user looks for e.g. <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">filter</code> they are pretty much guaranteed to quickly find the correct form, be it through code-completion, google or a fix-it.</li><li style="margin:15px 0px">There isn't really any violation of assumptions that might cause problems in this case.</li><li style="margin:15px 0px">Any mental pattern matching will likely transfer quickly due to the minimal difference.</li></ul><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#proposed-solution" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Proposed solution</h2><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">The proposed solution modifies the method verbs to their -ed/-ing forms (preferring the former). </p><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">It removes the last clear exceptions to the -ed/-ing rule from the standard library, which previously were exactly the opposite of what one would expect based on the API guidelines (and the rest of the language).</p><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">It also aids users in learning to pattern match on the -ed/-ing rule and internalizing the API guidelines, since now all methods are named this way – instead of the most commonly used methods defying the normal pattern.</p><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#detailed-design" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Detailed design</h2><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">The change would rename the following method families:</p><pre style="margin:0px 0px 16px;font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgb(247,247,247);color:rgb(51,51,51);border:1px solid rgb(204,204,204);overflow:auto;padding:16px;word-break:normal;word-wrap:normal;line-height:1.45"><code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:10pt;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:transparent;color:inherit;border:0px;margin:0px;padding:0px;word-break:normal;word-wrap:normal;display:inline;overflow:visible;line-height:inherit">map => mapped
flatMap => flatMapped
filter => filtered
reduce => reduced
dropFirst => droppingFirst
dropLast => droppingLast
</code></pre><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#impact-on-existing-code" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Impact on existing code</h2><p style="margin:0px 0px 16px;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px">The Swift migrator and fix-its would be provided for the change. </p><h2 style="font-weight:bold;border-bottom-width:1px;border-bottom-style:solid;border-bottom-color:rgb(238,238,238);color:rgb(51,51,51);font-size:1.75em;margin-top:1em;margin-bottom:16px;line-height:1.225;padding-bottom:0.3em;font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol'"><a href="https://github.com/PatrickPijnappel/swift-evolution/blob/functional-methods-ed-ing/proposals/XXXX-functional-methods-ed-ing.md#alternatives-considered" style="color:rgb(64,120,192);background-color:transparent;text-decoration:none;display:inline-block;padding-right:2px;line-height:1" target="_blank"></a>Alternatives considered</h2><ul style="margin-top:0px;margin-right:0px;margin-bottom:0px!important;margin-left:0px;padding-left:2em;color:rgb(51,51,51);font-family:'Helvetica Neue',Helvetica,'Segoe UI',Arial,freesans,sans-serif,'Apple Color Emoji','Segoe UI Emoji','Segoe UI Symbol';font-size:16px"><li style="margin:15px 0px">Alternatively -ing suffixes could be used for <code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">map</code>/<code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">flatMap</code>/<code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">filter</code>/<code style="font-family:Consolas,'Liberation Mono',Menlo,Courier,monospace;font-size:14px;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;background-color:rgba(0,0,0,0.0392157);color:inherit;border:1px solid rgb(234,234,234);margin:0px;padding:0.2em 0px;word-break:normal;word-wrap:normal">reduce</code>. However, these are normally reserved for when -ed doesn't really work (e.g. droppedFirst).</li></ul></div></div>_______________________________________________<br>swift-evolution mailing list<br><a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a><br><a href="https://lists.swift.org/mailman/listinfo/swift-evolution" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br></div></div></span></blockquote></div><div style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><div style="margin:15px 0px"><br></div></div><span style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254);float:none;display:inline!important">_______________________________________________</span><br style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><span style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254);float:none;display:inline!important">swift-evolution mailing list</span><br style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><a href="mailto:swift-evolution@swift.org" style="color:rgb(65,131,196);background-color:rgb(254,254,254);text-decoration:none;font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px" target="_blank">swift-evolution@swift.org</a><br style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"><a href="https://lists.swift.org/mailman/listinfo/swift-evolution" style="color:rgb(65,131,196);background-color:rgb(254,254,254);text-decoration:none;font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px" target="_blank">https://lists.swift.org/mailman/listinfo/swift-evolution</a><br style="font-family:Helvetica,Arial;font-size:13px;font-style:normal;font-weight:normal;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(254,254,254)"></div></blockquote></div><br></div></div></div></div></div></div><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>
<br></blockquote></div><br></div>