generic-library/googletest
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Merge pull request #2548 from kuzkry:update-pump-manual

Browse Source 
PiperOrigin-RevId: 278702531
This commit is contained in:
Xiaoyi Zhang 2019-11-05 17:08:27 -05:00
commit 8aedd597af
1 changed files with 8 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
googlemock/docs/pump_manual.md
View File

@ -6,18 +6,15 @@ Template and macro libraries often need to define many classes, functions, or
macros that vary only (or almost only) in the number of arguments they take. macros that vary only (or almost only) in the number of arguments they take.
It's a lot of repetitive, mechanical, and error-prone work. It's a lot of repetitive, mechanical, and error-prone work.
Variadic templates and variadic macros can alleviate the problem. However, while Our experience is that it's tedious to write custom scripts, which tend to
both are being considered by the C++ committee, neither is in the standard yet reflect the structure of the generated code poorly and are often hard to read
or widely supported by compilers. Thus they are often not a good choice, and edit. For example, a small change needed in the generated code may require
especially when your code needs to be portable. And their capabilities are still some non-intuitive, non-trivial changes in the script. This is especially
limited. painful when experimenting with the code.
As a result, authors of such libraries often have to write scripts to generate This script may be useful for generating meta code, for example a series of
their implementation. However, our experience is that it's tedious to write such macros of FOO1, FOO2, etc. Nevertheless, please make it your last resort
scripts, which tend to reflect the structure of the generated code poorly and technique by favouring C++ template metaprogramming or variadic macros.
are often hard to read and edit. For example, a small change needed in the
generated code may require some non-intuitive, non-trivial changes in the
script. This is especially painful when experimenting with the code.
# Our Solution # Our Solution