cerc-io/solidity
10
0
Fork 0
mirror of https://github.com/ethereum/solidity synced 2023-10-03 13:03:40 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

New note about which data locations are allowed in which function types

Browse Source 
Co-authored-by: Kamil Śliwak <cameel2@gmail.com>
This commit is contained in:
t11s 2021-07-18 15:02:16 -07:00 committed by GitHub
parent 61f33c53a0
commit c2dfbbf78c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
docs/types/reference-types.rst
View File

@ -29,11 +29,16 @@ annotation, the "data location", about where it is stored. There are three data
non-persistent area where function arguments are stored, and behaves mostly like memory. non-persistent area where function arguments are stored, and behaves mostly like memory.
.. note:: .. note::
If you can, try to use ``calldata`` as a data location because it will avoid copies and If you can, try to use ``calldata`` as data location because it will avoid copies and
also makes sure that the data cannot be modified. Calldata is typically preferred over also makes sure that the data cannot be modified. Arrays and structs with ``calldata``
memory in external functions (though not required after version 0.6.9). Arrays and data location can also be returned from functions, but it is not possible to
structs with ``calldata`` data location can also be returned from functions, but it allocate such types.
is not possible to allocate such types.
.. note::
Prior to version 0.6.9 data location for reference-type arguments was limited to
``calldata`` in external functions, ``memory`` in public functions and either
``memory`` or ``storage`` in internal and private ones.
Now ``memory`` and ``calldata`` are allowed in all functions regardless of their visibility.
.. note:: .. note::
Prior to version 0.5.0 the data location could be omitted, and would default to different locations Prior to version 0.5.0 the data location could be omitted, and would default to different locations