StarMirror/CppCoreGuidelines
1
0
Fork 0
mirror of https://github.com/isocpp/CppCoreGuidelines.git synced 2024-03-22 13:30:58 +08:00
Code Issues Projects Releases Wiki Activity

Use '<thing> template' i.s.o. 'template <thing>' (#1631)

Browse Source 
* Use '<thing> template' i.s.o. 'template <thing>'

The word 'template' is often wrongly used as an adjective to the 'thing'
it becomes when instantiated.

* Expand succinct formulation for readability

Co-authored-by: Kristoffel Pirard <kristoffel.pirard@vanhool.com>
This commit is contained in:
xtofl 2020-06-04 20:18:37 +02:00 committed by GitHub
parent 1936cb6b44
commit 4867a5c2d3
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
CppCoreGuidelines.md
View File

@ -1277,7 +1277,7 @@ What if the connection goes down so that no logging output is produced? See I.??
Note that non-`const` member functions pass information to other member functions through their object's state.
**Alternative formulation**: An interface should be a function or a set of functions.
Functions can be template functions and sets of functions can be classes or class templates.
Functions can be function templates and sets of functions can be classes or class templates.
##### Enforcement
@ -2663,7 +2663,7 @@ Member functions defined in-class are `inline` by default.
##### Exception
Template functions (incl. template member functions) are normally defined in headers and therefore inline.
Function templates (including member functions of class templates `A<T>::function()` and member function templates `A::function<T>()`) are normally defined in headers and therefore inline.
##### Enforcement
@ -4124,7 +4124,7 @@ For example, we can now change the representation of a `Date` without affecting
##### Note
Using a class in this way to represent the distinction between interface and implementation is of course not the only way.
For example, we can use a set of declarations of freestanding functions in a namespace, an abstract base class, or a template function with concepts to represent an interface.
For example, we can use a set of declarations of freestanding functions in a namespace, an abstract base class, or a function template with concepts to represent an interface.
The most important issue is to explicitly distinguish between an interface and its implementation "details."
Ideally, and typically, an interface is far more stable than its implementation(s).
@ -8079,7 +8079,7 @@ See [C.146](#Rh-dynamic_cast) and ???
## <a name="SS-overload"></a>C.over: Overloading and overloaded operators
You can overload ordinary functions, template functions, and operators.
You can overload ordinary functions, function templates, and operators.
You cannot overload function objects.
Overload rule summary:
@ -10335,7 +10335,7 @@ Flag variable and constant declarations with multiple declarators (e.g., `int* p
* Simple repetition is tedious and error-prone.
* When you use `auto`, the name of the declared entity is in a fixed position in the declaration, increasing readability.
* In a template function declaration the return type can be a member type.
* In a function template declaration the return type can be a member type.
##### Example
@ -17943,7 +17943,7 @@ Some people found the idea that the `Link` no longer was hidden inside the list
##### Note
A more general version of this rule would be
"If a template class member depends on only N template parameters out of M, place it in a base class with only N parameters."
"If a class template member depends on only N template parameters out of M, place it in a base class with only N parameters."
For N == 1, we have a choice of a base class of a class in the surrounding scope as in [T.61](#Rt-scary).
??? What about constants? class statics?