diff options
| author | Chris Lattner <sabre@nondot.org> | 2009-08-23 21:53:47 +0000 |
|---|---|---|
| committer | Chris Lattner <sabre@nondot.org> | 2009-08-23 21:53:47 +0000 |
| commit | ab71b787c3a25a3eafb74e5acd710c82d449c16c (patch) | |
| tree | 1825e1faa278b8aee36b7c6191ee232165ced249 /docs/CodingStandards.html | |
| parent | 6990417f292d9f6edc4f445bbece635af88203b2 (diff) | |
| download | external_llvm-ab71b787c3a25a3eafb74e5acd710c82d449c16c.zip external_llvm-ab71b787c3a25a3eafb74e5acd710c82d449c16c.tar.gz external_llvm-ab71b787c3a25a3eafb74e5acd710c82d449c16c.tar.bz2 | |
disuade people from using ostream.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@79866 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs/CodingStandards.html')
| -rw-r--r-- | docs/CodingStandards.html | 14 |
1 files changed, 8 insertions, 6 deletions
diff --git a/docs/CodingStandards.html b/docs/CodingStandards.html index ff707f3..8945216 100644 --- a/docs/CodingStandards.html +++ b/docs/CodingStandards.html @@ -990,12 +990,14 @@ library. There are two problems with this:</p> </ol> <p>Note that using the other stream headers (<tt><sstream></tt> for -example) is allowed normally, it is just <tt><iostream></tt> that is -causing problems.</p> - -<p>In addition, new code should always -use <a href="#ll_raw_ostream"><tt>raw_ostream</tt></a> or -the <tt>llvm::MemoryBuffer</tt> API (for reading in files).</p> +example) is not problematic in this regard (just <tt><iostream></tt>). +However, raw_ostream provides various APIs that are better performing for almost +every use than std::ostream style APIs, so you should just use it for new +code.</p> + +<p><b>New code should always +use <a href="#ll_raw_ostream"><tt>raw_ostream</tt></a> for writing, or +the <tt>llvm::MemoryBuffer</tt> API for reading files.</b></p> </div> |