nep1: prefer self to this (#16927)

This commit is contained in:
Timothee Cour 2021-02-04 05:09:53 -08:00 • committed by GitHub
commit 534a95aee0
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -162,10 +162,13 @@ to keep the names short but meaningful.
------------------- ------------ -------------------------------------- ------------------- ------------ --------------------------------------
English word To use Notes English word To use Notes
------------------- ------------ -------------------------------------- ------------------- ------------ --------------------------------------
initialize initT ``init`` is used to create a initialize initFoo initializes a value type ``Foo``
value type ``T`` new newFoo initializes a reference type ``Foo``
new newP ``new`` is used to create a via ``new``
reference type ``P`` this or self self for method like procs, e.g.:
`proc fun(self: Foo, a: int)`
rationale: `self` is more unique in english
than `this`, and `foo` would not be DRY.
find find should return the position where find find should return the position where
something was found; for a bool result something was found; for a bool result
use ``contains`` use ``contains``