Cold-Air-Networks/mirror-llvm-project
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 7

[flang] documentation

Browse source 
Original-commit: flang-compiler/f18@9aba35a258
Reviewed-on: https://github.com/flang-compiler/f18/pull/225
Tree-same-pre-rewrite: false
This commit is contained in:
peter klausler 2018-11-02 14:38:27 -07:00
parent 3eb69047df
commit 9ddf39811c
1 changed files with 17 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

17
flang/documentation/C++style.md
View file

@ -196,6 +196,23 @@ Safe to use *only* when the data are private to just one
thread of execution.
Used sparingly in place of `std::shared_ptr<>` only when the overhead
of that standard feature is prohibitive.
A feature matrix:
| pointer | nullable | default null | owning | reassignable | copyable |
| ------- | -------- | ------------ | ------ | ------------ | -------- |
| `*p` | yes | no | no | yes | shallowly |
| `&r` | no | n/a | no | no | shallowly |
| `unique_ptr<>` | yes | yes | yes | yes | no |
| `shared_ptr<>` | yes | yes | yes | yes | shallowly |
| `OwningPointer<>` | yes | yes | yes | yes | no |
| `Indirection<>` | no | n/a | yes | yes | optionally deeply |
| `CountedReference<>` | yes | yes | yes | yes | shallowly |
Note that `std::optional<Indirection<>>` checks all the boxes, if you
need a nullable `Indirection<>`.
### Overall design preferences
Don't use dynamic solutions to solve problems that can be solved at
build time; don't solve build time problems by writing programs that