Reputation: 5351
What is the difference between printf()
and cout
in C++?
Upvotes: 531
Views: 518197
Reputation: 539
TL;DR: Always do your own research, in regard of generated machine code size, performance, readability and coding time before trusting random comments online, including this one.
I'm no expert. I just happened to overhear two co-workers talking about how we should avoid using C++ in embedded systems because of performance issues. Well, interesting enough, I did a benchmark based on a real project task.
In said task, we had to write some config to RAM. Something like:
coffee=hot sugar=none milk=breast mac=AA:BB:CC:DD:EE:FF
Here's my benchmark programs (yes, I know the question asked about printf()
, not fprintf()
- this captures the essence, and anyway the link in the question points to fprintf()
anyway).
char coffee[10], sugar[10], milk[10];
unsigned char mac[6];
/* Initialize those things here. */
FILE * f = fopen("a.txt", "w");
fprintf(f, "coffee=%s\nsugar=%s\nmilk=%s\nmac=%02X:%02X:%02X:%02X:%02X:%02X\n", coffee, sugar, milk, mac[0], mac[1],mac[2],mac[3],mac[4],mac[5]);
fclose(f);
//Everything else is identical except:
std::ofstream f("a.txt", std::ios::out);
f << "coffee=" << coffee << "\n";
f << "sugar=" << sugar << "\n";
f << "milk=" << milk << "\n";
f << "mac=" << (int)mac[0] << ":"
<< (int)mac[1] << ":"
<< (int)mac[2] << ":"
<< (int)mac[3] << ":"
<< (int)mac[4] << ":"
<< (int)mac[5] << endl;
f.close();
I did my best to polish them before I looped them both 100,000 times. Here are the results:
Language | real | user | sys | object size |
---|---|---|---|---|
C | 8.01s | 2.37s | 5.58s | 2,092 bytes |
C++ | 6.07s | 3.18s | 2.84s | 3,272 bytes |
On my very specific platform, with a very specific processor, running a very specific version of Linux kernel, to run a program which is compiled with a very specific version of GCC, in order to accomplish a very specific task, I would say the C++ approach is more suitable because it runs significantly faster and provides much better readability. On the other hand, C offers small footprint, in my opinion, means nearly nothing because program size is not of our concern.
Remember, YMMV.
Upvotes: 2
Reputation: 28074
The idiomatic way to print to standard output from C++23 is with std::print
(or std::println
to add a newline), which uses {}
placeholders in the format string syntax:
#include <print>
int main()
{
std::println("{}, {} !", "Hello", "world");
}
Recent GCC (14.1) and Clang (18.1) both support using the <print>
header, so this program compiles and runs as expected (Live demo - Godbolt).
For prior versions of C++ (or older compilers), we can use the {fmt} library for a similar API (the C++ standard <print>
is actually based (mostly) on a subset of {fmt}).
See more about it in What are the differences between libfmt and std::format
?.
For more info about the format string syntax see {fmt} Format String Syntax.
Working example (Live demo - Godbolt):
#include <fmt/core.h>
int main()
{
fmt::println("{}, {} !", "Hello", "world");
}
Upvotes: 9
Reputation: 11839
Nowadays std::print
introduced in C++23 is preferred to both, but in case you are looking for differences between those old printing methods, I included a comparison of those.
Origin:
printf()
: Part of the C standard library, usable in both C and C++.cout
: Part of the C++ standard library, specific to C++.Type Safety:
printf():
Relies on format specifiers (%d
for integers, %s
for strings, etc.) to interpret data types. Incorrect format specifiers can lead to unexpected behavior or crashes. Chances are your C compiler will catch those issues however.cout
: Type-safe. It automatically determines the data type of variables being output and applies the appropriate formatting.Formatting:
printf()
: Offers a wide range of formatting options using format specifiers and flags. It provides more control over the output presentation.cout
: Provides basic formatting options like inserting spaces or newlines. It's generally less verbose for simple output compared to printf
.Object-Oriented Features:
printf()
: Not designed for object-oriented programming features of C++.cout
: Integrates seamlessly with C++ objects and can directly output objects using the insertion operator (<<
).Error Handling:
printf()
: Limited error handling capabilities. Issues like typos in format strings might not be caught until runtime.cout
: Provides some level of error checking. For instance, attempting to output data of an incompatible type might throw an exception.Performance:
printf()
: Generally considered faster than cout due to its lower-level implementation in the C library.cout
: Might have slight performance overhead due to type checking and potential error handling.When to Use Which:
cout
is preferred in C++.printf
might be a better choice.std::print
which offers a hybrid approach with positional arguments and some formatting capabilities.cout
offers a safer and more convenient way to handle output in C++ for most cases. printf
provides more low-level control and might be useful in specific scenarios where formatting or performance is a major priority.
Upvotes: 533
Reputation: 55524
API
printf
uses a replacement-based API with placeholders starting with %
replaced with formatted arguments:
printf("The answer is %d.\n", answer);
cout
or, more generally, ostreams use a concatenation-based API with parts of a formatted message interleaved with arguments:
std::cout << "The answer is " << answer << ".\n";
A replacement-based API with proper synchronization provides atomicity, e.g. when writing from multiple threads different messages written with printf
won't interleave while parts of the messages written with cout
may interleave. For this reason C++20 introduced std::osyncstream
which is a clunky way of achieving atomicity.
With operator overloading formatting can quickly become cumbersome, e.g.
std::cout << std::setprecision(2) << std::fixed << 1.23456 << "\n";
vs
printf("%.2f\n", 1.23456);
Matthew Wilson, the author of FastFormat, called this "chevron hell".
Extensibility
cout
supports formatting of user-defined types through overloading of operator<<
. There is no standard way to do the same with printf
, although there is a glibc extension which is rarely used in practice.
Safety
printf
uses varargs which are inherently unsafe unless you use something like GCC's format
attribute which only works with literal format strings. It is a user's responsibility to correctly pass type information via format specifiers. Any mismatch results in an undefined behavior and is a common source of vulnerabilities.
cout
/ostreams are type-safe and the user doesn't need to manually handle type information.
Buffering
cout
adds another layer of buffering and synchronizes with the underlying C streams by default. This brings significant performance overhead. It is possible to disable this synchronization at the cost of worse interoperability with C and potentially other languages.
Formatting state
In printf
formatting is controlled via a format string and decoupled from the stream itself. In cout
/ostreams the formatting state is stored in the stream which may negatively affect performance and cause unexpected results. Quoting N4412: Shortcomings of iostreams:
Formatting parameters (such as uppercase/lowercase and radix) are specified by setting flags, which mostly persist for an arbitrary number of subsequent low-level formatting operations, until explicitly changed. This approach inhibits compile-time checks and compile-time choice of formatting, and potentially establishes state shared between threads (which requires synchronization for access).
Locales
printf
uses the global C locale.
cout
uses the C++ locale associated with the stream.
Both printf
and cout
use locales by default.
Performance
cout
is often slower than printf
for reasons mentioned above: extra buffering and synchronization (can be disabled) and stateful API.
Language
printf
is a part of the C standard library and can be used in C and C++. cout
is a part of the C++ standard library and can only be used in C++.
You can have the best of both worlds by using C++23 std::print
. It provides a replacement-based API with positional arguments. It is extensible, type-safe, doesn't introduce extra buffering and makes localized formatting an opt-in.
Disclaimer: I'm the author of C++23 std::print
.
Upvotes: 10
Reputation: 6554
From the C++ FAQ:
[15.1] Why should I use
<iostream>
instead of the traditional<cstdio>
?Increase type safety, reduce errors, allow extensibility, and provide inheritability.
printf()
is arguably not broken, andscanf()
is perhaps livable despite being error prone, however both are limited with respect to what C++ I/O can do. C++ I/O (using<<
and>>
) is, relative to C (usingprintf()
andscanf()
):
- More type-safe: With
<iostream>
, the type of object being I/O'd is known statically by the compiler. In contrast,<cstdio>
uses "%" fields to figure out the types dynamically.- Less error prone: With
<iostream>
, there are no redundant "%" tokens that have to be consistent with the actual objects being I/O'd. Removing redundancy removes a class of errors.- Extensible: The C++
<iostream>
mechanism allows new user-defined types to be I/O'd without breaking existing code. Imagine the chaos if everyone was simultaneously adding new incompatible "%" fields toprintf()
andscanf()
?!- Inheritable: The C++
<iostream>
mechanism is built from real classes such asstd::ostream
andstd::istream
. Unlike<cstdio>
'sFILE*
, these are real classes and hence inheritable. This means you can have other user-defined things that look and act like streams, yet that do whatever strange and wonderful things you want. You automatically get to use the zillions of lines of I/O code written by users you don't even know, and they don't need to know about your "extended stream" class.
On the other hand, printf
is significantly faster, which may justify using it in preference to cout
in very specific and limited cases. Always profile first. (See, for example, http://programming-designs.com/2009/02/c-speed-test-part-2-printf-vs-cout/)
Upvotes: 228
Reputation: 1986
I'd like to point out that if you want to play with threads in C++, if you use cout
you can get some interesting results.
Consider this code:
#include <string>
#include <iostream>
#include <thread>
using namespace std;
void task(int taskNum, string msg) {
for (int i = 0; i < 5; ++i) {
cout << "#" << taskNum << ": " << msg << endl;
}
}
int main() {
thread t1(task, 1, "AAA");
thread t2(task, 2, "BBB");
t1.join();
t2.join();
return 0;
}
// g++ ./thread.cpp -o thread.out -ansi -pedantic -pthread -std=c++0x
Now, the output comes all shuffled. It can yield different results too, try executing several times:
##12:: ABABAB
##12:: ABABAB
##12:: ABABAB
##12:: ABABAB
##12:: ABABAB
You can use printf
to get it right, or you can use mutex
.
#1: AAA
#2: BBB
#1: AAA
#2: BBB
#1: AAA
#2: BBB
#1: AAA
#2: BBB
#1: AAA
#2: BBB
Have fun!
Upvotes: 4
Reputation: 113
I'm not a programmer, but I have been a human factors engineer. I feel a programming language should be easy to learn, understand and use, and this requires that it have a simple and consistent linguistic structure. Although all the languages is symbolic and thus, at its core, arbitrary, there are conventions and following them makes the language easier to learn and use.
There are a vast number of functions in C++ and other languages written as function(parameter), a syntax that was originally used for functional relationships in mathematics in the pre-computer era. printf()
follows this syntax and if the writers of C++ wanted to create any logically different method for reading and writing files they could have simply created a different function using a similar syntax.
In Python we of course can print using the also fairly standard object.method
syntax, i.e. variablename.print, since variables are objects, but in C++ they are not.
I'm not fond of the cout syntax because the << operator does not follow any rules. It is a method or function, i.e. it takes a parameter and does something to it. However it is written as though it were a mathematical comparison operator. This is a poor approach from a human factors standpoint.
Upvotes: 7
Reputation: 69
Of course you can write "something" a bit better to keep maintenance:
#include <iostream>
#include <cstdlib>
using namespace std;
class Something
{
public:
Something(int x, int y, int z) : a(x), b(y), c(z) { }
int a;
int b;
int c;
friend ostream& operator<<(ostream&, const Something&);
void print() const { printf("%i, %i, %i\n", a, b, c); }
};
ostream& operator<<(ostream& o, const Something& s)
{
o << s.a << ", " << s.b << ", " << s.c;
return o;
}
int main(void)
{
Something s(3, 2, 1);
// Output with printf
s.print(); // Simple as well, isn't it?
// Output with cout
cout << s << endl;
return 0;
}
And a bit extended test of cout vs. printf, added a test of 'double', if anyone wants to do more testing (Visual Studio 2008, release version of the executable):
#include <stdio.h>
#include <iostream>
#include <ctime>
class TimedSection {
char const *d_name;
//timespec d_start;
clock_t d_start;
public:
TimedSection(char const *name) :
d_name(name)
{
//clock_gettime(CLOCK_REALTIME, &d_start);
d_start = clock();
}
~TimedSection() {
clock_t end;
//clock_gettime(CLOCK_REALTIME, &end);
end = clock();
double duration = /*1e3 * (end.tv_sec - d_start.tv_sec) +
1e-6 * (end.tv_nsec - d_start.tv_nsec);
*/
(double) (end - d_start) / CLOCKS_PER_SEC;
std::cerr << d_name << '\t' << std::fixed << duration * 1000.0 << " ms\n";
}
};
int main() {
const int iters = 1000000;
char const *text = "01234567890123456789";
{
TimedSection s("cout with only endl");
for (int i = 0; i < iters; ++i)
std::cout << std::endl;
}
{
TimedSection s("cout with only '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << '\n';
}
{
TimedSection s("printf with only '\\n'");
for (int i = 0; i < iters; ++i)
printf("\n");
}
{
TimedSection s("cout with string constant and endl");
for (int i = 0; i < iters; ++i)
std::cout << "01234567890123456789" << std::endl;
}
{
TimedSection s("cout with string constant and '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << "01234567890123456789\n";
}
{
TimedSection s("printf with string constant and '\\n'");
for (int i = 0; i < iters; ++i)
printf("01234567890123456789\n");
}
{
TimedSection s("cout with some stuff and endl");
for (int i = 0; i < iters; ++i)
std::cout << text << "01234567890123456789" << i << std::endl;
}
{
TimedSection s("cout with some stuff and '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << text << "01234567890123456789" << i << '\n';
}
{
TimedSection s("printf with some stuff and '\\n'");
for (int i = 0; i < iters; ++i)
printf("%s01234567890123456789%i\n", text, i);
}
{
TimedSection s("cout with formatted double (width & precision once)");
std::cout << std::fixed << std::scientific << std::right << std::showpoint;
std::cout.width(8);
for (int i = 0; i < iters; ++i)
std::cout << text << 8.315 << i << '\n';
}
{
TimedSection s("cout with formatted double (width & precision on each call)");
std::cout << std::fixed << std::scientific << std::right << std::showpoint;
for (int i = 0; i < iters; ++i)
{ std::cout.width(8);
std::cout.precision(3);
std::cout << text << 8.315 << i << '\n';
}
}
{
TimedSection s("printf with formatted double");
for (int i = 0; i < iters; ++i)
printf("%8.3f%i\n", 8.315, i);
}
}
The result is:
cout with only endl 6453.000000 ms
cout with only '\n' 125.000000 ms
printf with only '\n' 156.000000 ms
cout with string constant and endl 6937.000000 ms
cout with string constant and '\n' 1391.000000 ms
printf with string constant and '\n' 3391.000000 ms
cout with some stuff and endl 9672.000000 ms
cout with some stuff and '\n' 7296.000000 ms
printf with some stuff and '\n' 12235.000000 ms
cout with formatted double (width & precision once) 7906.000000 ms
cout with formatted double (width & precision on each call) 9141.000000 ms
printf with formatted double 3312.000000 ms
Upvotes: 2
Reputation: 2059
Two points not otherwise mentioned here that I find significant:
1) cout
carries a lot of baggage if you're not already using the STL. It adds over twice as much code to your object file as printf
. This is also true for string
, and this is the major reason I tend to use my own string library.
2) cout
uses overloaded <<
operators, which I find unfortunate. This can add confusion if you're also using the <<
operator for its intended purpose (shift left). I personally don't like to overload operators for purposes tangential to their intended use.
Bottom line: I'll use cout
(and string
) if I'm already using the STL. Otherwise, I tend to avoid it.
Upvotes: 11
Reputation: 185852
One is a function that prints to stdout. The other is an object that provides several member functions and overloads of operator<<
that print to stdout. There are many more differences that I could enumerate, but I'm not sure what you are after.
Upvotes: 32
Reputation: 7720
More differences: "printf" returns an integer value (equal to the number of characters printed) and "cout" does not return anything
And.
cout << "y = " << 7;
is not atomic.
printf("%s = %d", "y", 7);
is atomic.
cout performs typechecking, printf doesn't.
There's no iostream equivalent of "% d"
Upvotes: 1
Reputation: 29
I would like say that extensibility lack of printf
is not entirely true:
In C, it is true. But in C, there are no real classes.
In C++, it is possible to overload cast operator, so, overloading a char*
operator and using printf
like this:
Foo bar;
...;
printf("%s",bar);
can be possible, if Foo overload the good operator. Or if you made a good method. In short, printf
is as extensible as cout
for me.
Technical argument I can see for C++ streams (in general... not only cout.) are:
Typesafety. (And, by the way, if I want to print a single '\n'
I use putchar('\n')
... I will not use a nuke-bomb to kill an insect.).
Simpler to learn. (no "complicated" parameters to learn, just to use <<
and >>
operators)
Work natively with std::string
(for printf
there is std::string::c_str()
, but for scanf
?)
For printf
I see:
Easier, or at least shorter (in term of characters written) complex formatting. Far more readable, for me (matter of taste I guess).
Better control of what the function made (Return how many characters where written and there is the %n
formatter: "Nothing printed. The argument must be a pointer to a signed int, where the number of characters written so far is stored." (from printf - C++ Reference)
Better debugging possibilities. For same reason as last argument.
My personal preferences go to printf
(and scanf
) functions, mainly because I love short lines, and because I don't think type problems on printing text are really hard to avoid.
The only thing I deplore with C-style functions is that std::string
is not supported. We have to go through a char*
before giving it to printf
(with the std::string::c_str()
if we want to read, but how to write?)
Upvotes: 1
Reputation: 14555
cout<< "Hello";
printf("%s", "Hello");
Both are used to print values. They have completely different syntax. C++ has both, C only has printf.
Upvotes: 2
Reputation: 1554
For me, the real differences which would make me go for 'cout' rather than 'printf' are:
1) << operator can be overloaded for my classes.
2) Output stream for cout can be easily changed to a file : (: copy paste :)
#include <iostream>
#include <fstream>
using namespace std;
int main ()
{
cout << "This is sent to prompt" << endl;
ofstream file;
file.open ("test.txt");
streambuf* sbuf = cout.rdbuf();
cout.rdbuf(file.rdbuf());
cout << "This is sent to file" << endl;
cout.rdbuf(sbuf);
cout << "This is also sent to prompt" << endl;
return 0;
}
3) I find cout more readable, especially when we have many parameters.
One problem with cout
is the formatting options. Formatting the data (precision, justificaton, etc.) in printf
is easier.
Upvotes: 14
Reputation: 870
With primitives, it probably doesn't matter entirely which one you use. I say where it gets usefulness is when you want to output complex objects.
For example, if you have a class,
#include <iostream>
#include <cstdlib>
using namespace std;
class Something
{
public:
Something(int x, int y, int z) : a(x), b(y), c(z) { }
int a;
int b;
int c;
friend ostream& operator<<(ostream&, const Something&);
};
ostream& operator<<(ostream& o, const Something& s)
{
o << s.a << ", " << s.b << ", " << s.c;
return o;
}
int main(void)
{
Something s(3, 2, 1);
// output with printf
printf("%i, %i, %i\n", s.a, s.b, s.c);
// output with cout
cout << s << endl;
return 0;
}
Now the above might not seem all that great, but let's suppose you have to output this in multiple places in your code. Not only that, let's say you add a field "int d." With cout, you only have to change it in once place. However, with printf, you'd have to change it in possibly a lot of places and not only that, you have to remind yourself which ones to output.
With that said, with cout, you can reduce a lot of times spent with maintenance of your code and not only that if you re-use the object "Something" in a new application, you don't really have to worry about output.
Upvotes: 3
Reputation: 181705
People often claim that printf
is much faster. This is largely a myth. I just tested it, with the following results:
cout with only endl 1461.310252 ms
cout with only '\n' 343.080217 ms
printf with only '\n' 90.295948 ms
cout with string constant and endl 1892.975381 ms
cout with string constant and '\n' 416.123446 ms
printf with string constant and '\n' 472.073070 ms
cout with some stuff and endl 3496.489748 ms
cout with some stuff and '\n' 2638.272046 ms
printf with some stuff and '\n' 2520.318314 ms
Conclusion: if you want only newlines, use printf
; otherwise, cout
is almost as fast, or even faster. More details can be found on my blog.
To be clear, I'm not trying to say that iostream
s are always better than printf
; I'm just trying to say that you should make an informed decision based on real data, not a wild guess based on some common, misleading assumption.
Update: Here's the full code I used for testing. Compiled with g++
without any additional options (apart from -lrt
for the timing).
#include <stdio.h>
#include <iostream>
#include <ctime>
class TimedSection {
char const *d_name;
timespec d_start;
public:
TimedSection(char const *name) :
d_name(name)
{
clock_gettime(CLOCK_REALTIME, &d_start);
}
~TimedSection() {
timespec end;
clock_gettime(CLOCK_REALTIME, &end);
double duration = 1e3 * (end.tv_sec - d_start.tv_sec) +
1e-6 * (end.tv_nsec - d_start.tv_nsec);
std::cerr << d_name << '\t' << std::fixed << duration << " ms\n";
}
};
int main() {
const int iters = 10000000;
char const *text = "01234567890123456789";
{
TimedSection s("cout with only endl");
for (int i = 0; i < iters; ++i)
std::cout << std::endl;
}
{
TimedSection s("cout with only '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << '\n';
}
{
TimedSection s("printf with only '\\n'");
for (int i = 0; i < iters; ++i)
printf("\n");
}
{
TimedSection s("cout with string constant and endl");
for (int i = 0; i < iters; ++i)
std::cout << "01234567890123456789" << std::endl;
}
{
TimedSection s("cout with string constant and '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << "01234567890123456789\n";
}
{
TimedSection s("printf with string constant and '\\n'");
for (int i = 0; i < iters; ++i)
printf("01234567890123456789\n");
}
{
TimedSection s("cout with some stuff and endl");
for (int i = 0; i < iters; ++i)
std::cout << text << "01234567890123456789" << i << std::endl;
}
{
TimedSection s("cout with some stuff and '\\n'");
for (int i = 0; i < iters; ++i)
std::cout << text << "01234567890123456789" << i << '\n';
}
{
TimedSection s("printf with some stuff and '\\n'");
for (int i = 0; i < iters; ++i)
printf("%s01234567890123456789%i\n", text, i);
}
}
Upvotes: 57
Reputation: 25277
And I quote:
In high level terms, the main differences are type safety (cstdio doesn't have it), performance (most iostreams implementations are slower than the cstdio ones) and extensibility (iostreams allows custom output targets and seamless output of user defined types).
Upvotes: 44