stdcxx-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Jim Bell (JIRA)" <j...@apache.org>
Subject [jira] Created: (STDCXX-1048) rotate() description's example seems misleading or wrong
Date Tue, 30 Mar 2010 23:56:27 GMT
rotate() description's example seems misleading or wrong
--------------------------------------------------------

                 Key: STDCXX-1048
                 URL: https://issues.apache.org/jira/browse/STDCXX-1048
             Project: C++ Standard Library
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 4.2.1
            Reporter: Jim Bell
            Priority: Minor


rotate() description's example seems misleading at best. It says:

{quote}
Say that we have the sequence:

{{2 4 6 8 1 3 5}}

If we call rotate() with mid pointing to {{5}}, the two segments are

{{2 4 6 8}} and {{1 3 5}}
{quote}

To get the specified result, the mid must point to the fifth element, counting up from 1.
But it would be more accurate to say "with mid pointing to {{advance(start, 4)}} ..." Further,
the typeface for "5" makes it look like the item value 5, the last position on the original
sequence list.



-- 
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.


Mime
View raw message