julia icon indicating copy to clipboard operation
julia copied to clipboard

Update asyncmap docs to clarify order of outputs

Open haakon-e opened this issue 1 year ago • 3 comments

small addition to asyncmap docstring to clarify that order of output is same as input:

The output is guaranteed to be the same order as the elements of the collection(s) c.

I added it to clarify the behavior, especially for new users, and, afaik because it is not consistent across programming languages.

Happy to iterate if there should be updates to doc pages too.

haakon-e avatar Jun 28 '24 17:06 haakon-e

Should this actually be guaranteed, or is this a case of "that's what it happens to do right now"?

Seelengrab avatar Jun 28 '24 17:06 Seelengrab

Should this actually be guaranteed, or is this a case of "that's what it happens to do right now"?

I will have to defer a definitive answer to that question for someone else. I'm basing my PR on the answer to a question I had about this in the julia slack. In any case, clarification either way for what I should expect (or not expect) would be useful to have in the docs.

haakon-e avatar Jun 28 '24 17:06 haakon-e

It should be semantically guaranteed since it is supposed to be like map (and this order is a big reason this function is useful)

ericphanson avatar Jun 28 '24 18:06 ericphanson

Thanks!

LilithHafner avatar Aug 10 '24 22:08 LilithHafner