[
https://issues.apache.org/jira/browse/STDCXX-1025?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Martin Sebor closed STDCXX-1025.
--------------------------------
Resolution: Fixed
Fixed in [r720080 | http://svn.apache.org/viewvc?rev=720080&view=rev] on 4.2.x.
Merged to 4.3.x in [r720082 | http://svn.apache.org/viewvc?rev=720082&view=rev]
and to trunk in [r720083 | http://svn.apache.org/viewvc?rev=720083&view=rev].
> Documentation for ios_base::flags and ios_base::setf misleading
> ---------------------------------------------------------------
>
> Key: STDCXX-1025
> URL: https://issues.apache.org/jira/browse/STDCXX-1025
> Project: C++ Standard Library
> Issue Type: Bug
> Components: Documentation
> Affects Versions: 4.2.1
> Reporter: Elmar Zander
> Assignee: Martin Sebor
> Priority: Minor
> Fix For: 4.2.2
>
> Original Estimate: 1h
> Time Spent: 1h
> Remaining Estimate: 0h
>
> The documentation says for boths "flags(fmtflags fmtfl)" and "setf(fmtflags
> fmtfl)" exactly the same, which is not true:
> flags(fmtflags fmtfl);
> Saves the format control information, then sets it to fmtfl and returns
> the previously saved value.
> setf(fmtflags fmtfl);
> Saves the format control information, then sets it to fmtfl and returns
> the previously saved value.
> The documentation in the header file "ios_base.h" is indeed better. It states
> for flags:
> > This function overwrites all the format flags with @a fmtfl.
> while for setf it says:
> > This function sets additional flags in format control. Flags that were
> > previously set remain set.
> BTW: The start of the sentences "Saves the format control information..." is
> confusing anyway and not necessary for anyone using this interface. It's
> enough to know that the function "returns the previously saved value".
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
