mirror of
https://github.com/triqs/dft_tools
synced 2024-11-01 19:53:45 +01:00
3fe400d34c
- examples split from the rst file using a python script (split_code). - Final result for the doc is unchanged. - examples are compiled and tested with the other tests. - examples' code have been clang-formatted, with triqs style. - doc compiles much faster, and with the same options as the rest of the test. - examples are added as tests, so they are run by make test, as simple C tests. - done for the tutorials and the reference. - autocompile removed (changed into triqs_example directive). - add triqs_example : - make a literal include of the source code. - runs the compiled example - add, as before, the result to the source code in the doc. - added the script split_code, used to make the changes automatically, maybe for later reuse. (in _tools)
41 lines
978 B
ReStructuredText
41 lines
978 B
ReStructuredText
|
|
swap & deep_swap
|
|
==================================
|
|
|
|
There are two possible interpretation of "swapping two arrays" :
|
|
either use 3 moves like std::swap, i.e. swapping the pointer to the data in memory,
|
|
or making a deep swap, i.e. really swapping all the elements in memeory.
|
|
|
|
.. _arr_swap:
|
|
|
|
swap
|
|
--------
|
|
|
|
* swap just exchange the (shared) pointer to the data in memory,
|
|
it does not affect the data them self.
|
|
This distinction of importance for views in particular.
|
|
|
|
* For the regular type, std::swap and swap are equivalent.
|
|
For the views, std::swap is explicitely deleted, since it is incorrect
|
|
due to the lack of move constructor for a view.
|
|
Use `swap` instead.
|
|
|
|
* **Example** :
|
|
|
|
.. triqs_example:: ./swap_0.cpp
|
|
.. _arr_deep_swap:
|
|
|
|
deep_swap
|
|
--------------
|
|
|
|
.. warning::
|
|
|
|
Currently implemented only for triqs::vector and triqs::vector_view.
|
|
|
|
|
|
* deep_swap swaps the data in memory.
|
|
|
|
* **Example** (compare with swap) :
|
|
|
|
.. triqs_example:: ./swap_1.cpp
|