Why does the string returned by ctime() contain a line feed?

C++CStringTimeStd

C++ Problem Overview


Why does the string returned by ctime() have a line feed (0x0A) as its final character? For example, this code:

#include <iostream>
#include <cstdlib>

int main(int argc, char* argv[])
{
    time_t now;
    time(&now);
    char* time_str = ctime(&now);
    std::cout << time_str << "why is this on a new line?" << std::endl;
    return 0;
}

...produces the following output:

$ ./time.exe
Wed Oct 23 14:52:29 2013
why is this on a new line?
$ 

It's not a big deal; I can strip the final byte from the string, but why does ctime() put it there in the first place?

C++ Solutions


Solution 1 - C++

According to the C99 Rationale, the new line exists because of existing practice, which I think it's the same as saying for historical reasons.

>###Rationale for International Standard — Programming Languages — C §7.23.3.1 The asctime function

>Although the name of this function suggests a conflict with the principle of removing ASCII dependencies from the Standard, the name was retained due to prior art. For the same reason of existing practice, a proposal to remove the newline character from the string format was not adopted.

This talks about asctime, but since ctime is equivalent to asctime(localtime(timer)), so the same rule applies.

Solution 2 - C++

The POSIX Standard claims historical compatibility:

> [asctime] is included for compatibility with older implementations ... Applications should use strftime() to achieve maximum portability.

Given that it was included for compatibility with older implementations, it's reasonable to assume that some older library implemented asctime with a newline at the end

Solution 3 - C++

This behaviour is required as defined in the ISO 9899:1990 specification.

7.12.3.1 The asctime function

The asctime function converts the broken-down time in the structure
pointed to by timeptr into a string in the form

         Sun Sep 16 01:03:52 1973\n\0

7.12.3.2 The ctime function

The ctime function converts the calendar time pointed to by timer to
local time in the form of a string.  It is equivalent to 

         asctime(localtime(timer))

Solution 4 - C++

It could be because originally it was required to implement the date program in Unix. (So maybe a newline for the shell)? So for historical reasons maybe.

Solution 5 - C++

If you want your own format (one without the newline), use strftime() instead. The format string "%c" should give you roughly the same format but without the newline.

Solution 6 - C++

The asctime() man page does mention (but does not emphasize) that the returned string has a terminating newline character before the terminating null character. Why this information is not also present in the ctime man page is a mystery.

Attributions

All content for this solution is sourced from the original question on Stackoverflow.

The content on this page is licensed under the Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license.

Content TypeOriginal AuthorOriginal Content on Stackoverflow
QuestionbythescruffView Question on Stackoverflow
Solution 1 - C++Yu HaoView Answer on Stackoverflow
Solution 2 - C++SheetJSView Answer on Stackoverflow
Solution 3 - C++Delan AzabaniView Answer on Stackoverflow
Solution 4 - C++SadiqueView Answer on Stackoverflow
Solution 5 - C++SneftelView Answer on Stackoverflow
Solution 6 - C++JamesUView Answer on Stackoverflow