[Numpy-discussion] Shouldn't all in-place operations simply return self?

[Jim Vickroy]

On 1/16/2013 11:41 PM, Nathaniel Smith wrote:
>
> On 16 Jan 2013 17:54, <josef.pktd at gmail.com 
> <mailto:josef.pktd at gmail.com>> wrote:
> > >>> a = np.random.random_integers(0, 5, size=5)
> > >>> b = a.sort()
> > >>> b
> > >>> a
> > array([0, 1, 2, 5, 5])
> >
> > >>> b = np.random.shuffle(a)
> > >>> b
> > >>> b = np.random.permutation(a)
> > >>> b
> > array([0, 5, 5, 2, 1])
> >
> > How do I remember if shuffle shuffles or permutes ?
> >
> > Do we have a list of functions that are inplace?
>
> I rather like the convention used elsewhere in Python of naming 
> in-place operations with present tense imperative verbs, and 
> out-of-place operations with past participles. So you have 
> sort/sorted, reverse/reversed, etc.
>
> Here this would suggest we name these two operations as either 
> shuffle() and shuffled(), or permute() and permuted().
>

I like this (tense) suggestion.  It seems easy to remember.  --jv


> -n
>
>
>
> _______________________________________________
> NumPy-Discussion mailing list
> NumPy-Discussion at scipy.org
> http://mail.scipy.org/mailman/listinfo/numpy-discussion

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/numpy-discussion/attachments/20130117/92ea61ed/attachment.html>