|
3711 | 3711 | \pnum
|
3712 | 3712 | The
|
3713 | 3713 | \term{pending sequence}
|
3714 |
| -of characters is defined as the concatenation of: |
3715 |
| -\begin{enumeratea} |
3716 |
| -\item |
3717 |
| -If |
3718 |
| -\tcode{gptr()} |
3719 |
| -is non-null, then the |
| 3714 | +of characters is defined as the concatenation of |
| 3715 | +\begin{itemize} |
| 3716 | +\item the empty sequence if \tcode{gptr()} is null, otherwise the |
3720 | 3717 | \tcode{egptr() - gptr()}
|
3721 | 3718 | characters starting at
|
3722 | 3719 | \tcode{gptr()},
|
3723 |
| -otherwise the empty sequence. |
| 3720 | +followed by |
3724 | 3721 | \item
|
3725 |
| -Some sequence (possibly empty) of characters read from the input sequence. |
3726 |
| -\end{enumeratea} |
| 3722 | +some (possibly empty) sequence of characters read from the input sequence. |
| 3723 | +\end{itemize} |
3727 | 3724 |
|
3728 | 3725 | \pnum
|
3729 | 3726 | The
|
3730 | 3727 | \term{result character}
|
3731 | 3728 | is
|
3732 |
| -\begin{enumeratea} |
3733 |
| -\item |
3734 |
| -If the pending sequence is non-empty, the first character of the sequence. |
3735 |
| -\item |
3736 |
| -If the pending sequence |
3737 |
| -is |
3738 |
| -empty then the next character that would be read from the input sequence. |
3739 |
| -\end{enumeratea} |
| 3729 | +the first character of the pending sequence if it is non-empty, |
| 3730 | +otherwise |
| 3731 | +the next character that would be read from the input sequence. |
3740 | 3732 |
|
3741 | 3733 | \pnum
|
3742 | 3734 | The
|
3743 | 3735 | \term{backup sequence}
|
3744 |
| -is defined as the concatenation of: |
3745 |
| -\begin{enumeratea} |
3746 |
| -\item |
3747 |
| -If |
3748 |
| -\tcode{eback()} |
3749 |
| -is null then empty, |
3750 |
| -\item |
3751 |
| -Otherwise the |
| 3736 | +is the empty sequence if \tcode{eback()} is null, otherwise the |
3752 | 3737 | \tcode{gptr() - eback()}
|
3753 | 3738 | characters beginning at
|
3754 | 3739 | \tcode{eback()}.
|
3755 |
| -\end{enumeratea} |
3756 | 3740 |
|
3757 | 3741 | \pnum
|
3758 | 3742 | \effects
|
3759 | 3743 | The function sets up the
|
3760 | 3744 | \tcode{gptr()}
|
3761 | 3745 | and
|
3762 | 3746 | \tcode{egptr()}
|
3763 |
| -satisfying one of: |
3764 |
| -\begin{enumeratea} |
3765 |
| -\item |
3766 |
| -If the pending sequence is non-empty, |
| 3747 | +such that |
| 3748 | +if the pending sequence is non-empty, then |
3767 | 3749 | \tcode{egptr()}
|
3768 | 3750 | is non-null and
|
3769 | 3751 | \tcode{egptr() - gptr()}
|
3770 | 3752 | characters starting at
|
3771 | 3753 | \tcode{gptr()}
|
3772 |
| -are the characters in the pending sequence |
3773 |
| -\item |
3774 |
| -If the pending sequence is empty, either |
3775 |
| -\tcode{gptr()} |
| 3754 | +are the characters in the pending sequence, otherwise |
| 3755 | +either \tcode{gptr()} |
3776 | 3756 | is null or
|
3777 |
| -\tcode{gptr()} |
3778 |
| -and |
3779 |
| -\tcode{egptr()} |
3780 |
| -are set to the same non-null pointer value. |
3781 |
| -\end{enumeratea} |
| 3757 | +\tcode{gptr() == egptr()}. |
3782 | 3758 |
|
3783 | 3759 | \pnum
|
3784 | 3760 | If
|
3785 | 3761 | \tcode{eback()}
|
3786 | 3762 | and
|
3787 | 3763 | \tcode{gptr()}
|
3788 |
| -are non-null then the function is not constrained as to their contents, but the ``usual backup condition'' is that either: |
3789 |
| -\begin{enumeratea} |
| 3764 | +are non-null then the function is not constrained as to their contents, but the ``usual backup condition'' is that either |
| 3765 | +\begin{itemize} |
3790 | 3766 | \item
|
3791 |
| -If the backup sequence contains at least |
| 3767 | +the backup sequence contains at least |
3792 | 3768 | \tcode{gptr() - eback()}
|
3793 |
| -characters, then the |
| 3769 | +characters, in which case the |
3794 | 3770 | \tcode{gptr() - eback()}
|
3795 | 3771 | characters starting at
|
3796 | 3772 | \tcode{eback()}
|
3797 | 3773 | agree with the last
|
3798 | 3774 | \tcode{gptr() - eback()}
|
3799 |
| -characters of the backup sequence. |
| 3775 | +characters of the backup sequence, or |
3800 | 3776 | \item
|
3801 |
| -Or the \tcode{n} characters starting at |
| 3777 | +the \tcode{n} characters starting at |
3802 | 3778 | \tcode{gptr() - n}
|
3803 |
| -agree with the backup sequence (where \tcode{n} is the length of the backup sequence) |
3804 |
| -\end{enumeratea} |
| 3779 | +agree with the backup sequence (where \tcode{n} is the length of the backup sequence). |
| 3780 | +\end{itemize} |
3805 | 3781 |
|
3806 | 3782 | \pnum
|
3807 | 3783 | \default
|
|
3952 | 3928 | Consumes some initial subsequence of the characters of the
|
3953 | 3929 | \term{pending sequence}.
|
3954 | 3930 | The pending sequence is defined as the concatenation of
|
3955 |
| -\begin{enumeratea} |
| 3931 | +\begin{itemize} |
3956 | 3932 | \item
|
3957 |
| -if |
3958 |
| -\tcode{pbase()} |
3959 |
| -is null then the empty sequence otherwise, |
| 3933 | +the empty sequence if \tcode{pbase()} is not null, otherwise the |
3960 | 3934 | \tcode{pptr() - pbase()}
|
3961 | 3935 | characters beginning at
|
3962 |
| -\tcode{pbase()}. |
| 3936 | +\tcode{pbase()}, followed by |
3963 | 3937 | \item
|
| 3938 | +the empty sequence |
3964 | 3939 | if
|
3965 | 3940 | \tcode{traits::eq_int_type(c, traits::eof())}
|
3966 | 3941 | returns
|
3967 |
| -\tcode{true}, |
3968 |
| -then the empty sequence |
3969 |
| -otherwise, the sequence consisting of \tcode{c}. |
3970 |
| -\end{enumeratea} |
| 3942 | +\tcode{true}, otherwise the sequence consisting of \tcode{c}. |
| 3943 | +\end{itemize} |
3971 | 3944 |
|
3972 | 3945 | \pnum
|
3973 | 3946 | \remarks
|
|
0 commit comments