<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div>I'm not giving my opinion, but quoting Ben Cohen's great list of questions to ask ourselves before adding something to the Standard Library:</div><div id="AppleMailSignature"><br></div><div id="AppleMailSignature"><p class="" style="box-sizing: border-box; margin-top: 0px; margin-bottom: 16px;"><span style="background-color: rgba(255, 255, 255, 0);">All methods added to the standard library increase complexity, so need a strong justification to reduce the risk of API sprawl. When requesting additions/modifications, please keep the following questions in mind:</span></p><ol class="" style="box-sizing: border-box; padding-left: 2em; margin-top: 0px; margin-bottom: 16px;"><li class="" style="box-sizing: border-box;"><span style="background-color: rgba(255, 255, 255, 0);">Is the suggested addition a common operation that many would find useful? Can it be flexible enough to cover different needs?</span></li><li class="" style="box-sizing: border-box; margin-top: 0.25em;"><span style="background-color: rgba(255, 255, 255, 0);">Will it encourage good practice? Might it be misused or encourage anti-patterns?</span></li><li class="" style="box-sizing: border-box; margin-top: 0.25em;"><span style="background-color: rgba(255, 255, 255, 0);">Can the operation be composed simply from existing std lib features? Is that composition intuitive/readable? </span></li><li class="" style="box-sizing: border-box; margin-top: 0.25em;"><span style="background-color: rgba(255, 255, 255, 0);">Is writing the equivalent by hand hard to get right? Are there common correctness traps that this addition would help avoid?</span></li><li class="" style="box-sizing: border-box; margin-top: 0.25em;"><span style="background-color: rgba(255, 255, 255, 0);">Is writing the equivalent by hand hard to make efficient? Are there common performance traps that this addition would help avoid?</span></li><li class="" style="box-sizing: border-box; margin-top: 0.25em;"><span style="background-color: rgba(255, 255, 255, 0);">Might a native implementation be able to execute more efficiently, by accessing internals, than the equivalent implementation using public APIs?</span></li></ol></div><div><br>On 2 May 2017, at 07:02, Xiaodi Wu via swift-evolution <<a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a>> wrote:<br><br></div><blockquote type="cite"><div><div dir="ltr">On Mon, May 1, 2017 at 9:34 PM, Karl Wagner via swift-evolution <span dir="ltr"><<a href="mailto:swift-evolution@swift.org" target="_blank">swift-evolution@swift.org</a>></span> wrote:<br><div class="gmail_extra"><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div style="word-wrap:break-word">Currently, we have the Repeated<T> type, which presents a single element as though it were a Collection. <div><div><br></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div><font face="Courier">> for i in repeatElement(1, count: 3) { print(i) }</font></div><div><font face="Courier">1</font></div><div><font face="Courier">1</font></div><div><font face="Courier">1</font></div><div><font face="Courier"><br></font></div><div><font face="Courier">> for i in repeatElement([1, 2, 3], count: 3) { print(i) }</font></div><div><font face="Courier">[1, 2, 3]</font></div><div><font face="Courier">[1, 2, 3]</font></div><div><font face="Courier">[1, 2, 3]</font></div></blockquote><div><br></div><div>However, we lack the ability for Collections to repeat their contents in a single list; basically, some kind of “flatMap” to repeatElement’s “map”. So I’d like to pitch a new API for repeated values. </div><div><br></div><div>- We would add a RepeatCollection<C: Collection> type, which loops over its base Collection a certain number of times (or until a maximum ‘count’). </div><div> Implementation might look something like this (<a href="https://gist.github.com/karwa/5228974a0b4dfd000a916f0aac2721c6" target="_blank">https://gist.github.com/<wbr>karwa/<wbr>5228974a0b4dfd000a916f0aac2721<wbr>c6</a>), except that we’d add some optimised map(), filter() and contains() functions which apply the algorithm once to the base and multiply the result.</div><div><br></div><div>- We would add 3 new functions to all Collections:</div><div><br></div></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div><div><font face="Courier">/// Repeats the collection <i>itself</i> N times.</font></div></div><div><div><font face="Courier">///</font></div></div><div><div><font face="Courier">func repeated(_ times: Int) -> RepeatCollection<<wbr>CollectionOfOne<Self>></font></div></div><div><div><font face="Courier"><br></font></div></div><div><div><font face="Courier">/// Repeats the collection’s <i>contents</i> N times.</font></div></div><div><div><font face="Courier">///</font></div></div><div><div><font face="Courier">func repeatElements(_ times: Int) -> RepeatCollection<Self></font></div></div><div><div><font face="Courier"><br></font></div></div><div><div><font face="Courier">/// Loops the collection’s contents to present a Collection of length N.</font></div></div><div><div><font face="Courier">///</font></div></div><div><div><font face="Courier">func repeatElements(count: Int) -> RepeatCollection<Self></font></div></div></blockquote><div><div><br></div><div>- We would replace the existing Repeated<T> type with a typealias to RepeatCollection<<wbr>CollectionOfOne<T>></div><div>- The existing, top-level repeatElement(T, Int) function <i>could</i> stay, but could also be replaced with an incantation on CollectionOfOne. I’m fairly ambivalent about this point - it’d be nice to see the function go, but the replacement also isn’t obvious.</div><div><br></div><div>Example usage of the new API:</div><div><br></div><blockquote style="margin:0 0 0 40px;border:none;padding:0px"><div><font face="Courier">// Equivalent to repeatElement(1, count: 3)</font></div><div><font face="Courier"><br></font></div><div><font face="Courier">> for i in CollectionOfOne(1).<wbr>repeatElements(3).forEach { print(i) }</font></div><div><font face="Courier">1</font></div><div><font face="Courier">1</font></div><div><font face="Courier">1</font></div><div><font face="Courier"><br></font></div><div><font face="Courier">// Equivalent to repeatElement([1, 2, 3], count: 3)</font></div><div><font face="Courier"><br></font></div><div><div><font face="Courier">> for i in [1, 2, 3].repeated(3).forEach { print(i) }</font></div><div><font face="Courier">[1, 2, 3]</font></div><div><span style="font-family:Courier">[1, 2, 3]</span></div><div><span style="font-family:Courier">[1, 2, 3]</span></div></div><div><span style="font-family:Courier"><br></span></div><div><span style="font-family:Courier">// New, flat repetition</span></div><div><font face="Courier"><br></font></div><div><font face="Courier">> for i in [1, 2, 3].repeatElements(3) { print(i) }</font></div><div><font face="Courier">1</font></div><div><font face="Courier">2</font></div><div><font face="Courier">3</font></div><div><font face="Courier">1</font></div><div><font face="Courier">2</font></div><div><font face="Courier">3</font></div><div><font face="Courier">1</font></div><div><font face="Courier">2</font></div><div><font face="Courier">3</font></div><div><font face="Courier"><br></font></div><div><div><span style="font-family:Courier">// New, flat repetition</span></div><div><font face="Courier"><br></font></div><div><font face="Courier">> for i in [1, 2, 3].repeatElements(count: 4) { print(i) }</font></div><div><font face="Courier">1</font></div><div><font face="Courier">2</font></div><div><font face="Courier">3</font></div><div><font face="Courier">1</font></div><div><br></div></div><div><font face="Courier">// Additional benefit: you can now repeat slices!</font></div><div><font face="Courier"><br></font></div><div><font face="Courier">> String(“yellow”.characters.<wbr>dropFirst().dropLast().repeat(<wbr>times: 3))</font></div><div><font face="Courier">“elloelloello"</font></div><div><br></div><div><br></div></blockquote>Thoughts?</div></div></blockquote><div><br></div><div>OK, now as to your proposed APIs themselves, here are some critiques:</div><div><br></div><div>The issue you've identified with the cumbersome nature of CollectionOfOne shows why repeatElement is currently a top-level function and intentionally so. In brief, there's nothing special about Collection to make it the obvious type on which to provide a `repeated` method. The _result_ of that operation is a collection, but there's no reason the argument has to be. The correct "type" on which to provide that method would be Any, IMO, but of course we cannot provide extensions on Any. In general, in such scenarios, the consistent design choice in the standard library is to provide a free function.</div><div><br></div><div>Here, it is not inconsistent to _add_ something for repeating the elements in a collection (to Collection itself) without also stuffing the existing `repeatElement` functionality into Collection. TBH, the latter seems like an orthogonal topic included for the express purpose of eliminating top-level functions, without addressing the underlying reason for the existence of these top-level functions in the first place (no extensions on Any). So again, unrelated and worth setting aside, IMO.</div><div><br></div><div>Other minor points include that `repeatElements` doesn't meet standard API naming guidelines. It should be `repeatingElements`. You also intuitively tacked on a `times` argument label in the example usage even though your proposed API doesn't have it. It suggests that `repeat[ing]Elements(3)` is actually quite ambiguous: repeat the value 3, repeat the whole collection 3 times, or repeat so that the final count is 3? Better to have the label always, I should think. Another point is that it'd take some justification to include both flavors of `repeat[ing]Elements`, as repeating until a final count is trivially composed with new one-sided ranges: `[1, 2, 3].repeatingElements(times: .max)[..<4]`.</div><div><br></div><div><br></div></div></div></div>
</div></blockquote><blockquote type="cite"><div><span>_______________________________________________</span><br><span>swift-evolution mailing list</span><br><span><a href="mailto:swift-evolution@swift.org">swift-evolution@swift.org</a></span><br><span><a href="https://lists.swift.org/mailman/listinfo/swift-evolution">https://lists.swift.org/mailman/listinfo/swift-evolution</a></span><br></div></blockquote></body></html>