|
3696 | 3696 | \tcode{underflow} |
3697 | 3697 | or |
3698 | 3698 | \tcode{uflow} |
3699 | | -might fail by throwing an exception prematurely. |
| 3699 | +can fail by throwing an exception prematurely. |
3700 | 3700 | The intention is not only that the calls will not return |
3701 | 3701 | \tcode{eof()} |
3702 | 3702 | but that they will return ``immediately''. |
|
3927 | 3927 | \tcode{traits::eof()} |
3928 | 3928 | to indicate failure. |
3929 | 3929 | Failure may occur because the input sequence could not be backed up, or if for some |
3930 | | -other reason the pointers could not be set consistent with the constraints. |
| 3930 | +other reason the pointers cannot be set consistent with the constraints. |
3931 | 3931 | \tcode{pbackfail()} |
3932 | 3932 | is called only when put back has really failed. |
3933 | 3933 |
|
|
7883 | 7883 | \pnum |
7884 | 7884 | \begin{note} |
7885 | 7885 | For efficiency reasons, |
7886 | | -stream buffer operations might violate invariants of \tcode{buf} |
| 7886 | +stream buffer operations can violate invariants of \tcode{buf} |
7887 | 7887 | while it is held encapsulated in the \tcode{basic_stringbuf}, |
7888 | 7888 | e.g., by writing to characters in the range |
7889 | 7889 | \range{\tcode{buf.data() + buf.size()}}{\tcode{buf.data() + buf.capacity()}}. |
|
12691 | 12691 | \effects |
12692 | 12692 | Appends \tcode{path(x).native()} to the pathname in the native format. |
12693 | 12693 | \begin{note} |
12694 | | -This directly manipulates the value of \tcode{native()} |
12695 | | -and might not be portable between operating systems. |
| 12694 | +This directly manipulates the value of \tcode{native()}, |
| 12695 | +which is not necessarily portable between operating systems. |
12696 | 12696 | \end{note} |
12697 | 12697 |
|
12698 | 12698 | \pnum |
|
13877 | 13877 | \tcode{file_type} constants |
13878 | 13878 | to separately identify each of those additional file types \\ \rowsep |
13879 | 13879 | \tcode{unknown} & |
13880 | | -The file exists but the type could not be determined \\ |
| 13880 | +The file exists but the type cannot be determined \\ |
13881 | 13881 | \end{floattable} |
13882 | 13882 |
|
13883 | 13883 | \rSec3[fs.enum.copy.opts]{Enum class \tcode{copy_options}} |
|
14942 | 14942 | \pnum |
14943 | 14943 | \begin{note} |
14944 | 14944 | If the directory structure being iterated over contains cycles |
14945 | | -then the end iterator might be unreachable. |
| 14945 | +then it is possible that the end iterator is unreachable. |
14946 | 14946 | \end{note} |
14947 | 14947 |
|
14948 | 14948 | \rSec3[fs.rec.dir.itr.members]{Members} |
|
15290 | 15290 |
|
15291 | 15291 | \pnum |
15292 | 15292 | \begin{note} |
15293 | | -To resolve symlinks, |
15294 | | -or perform other sanitization which might require queries to secondary storage, |
| 15293 | +To resolve symlinks |
| 15294 | +or perform other sanitization that can involve queries to secondary storage, |
15295 | 15295 | such as hard disks, consider \tcode{canonical}\iref{fs.op.canonical}. |
15296 | 15296 | \end{note} |
15297 | 15297 |
|
|
15865 | 15865 | \pnum |
15866 | 15866 | \begin{note} |
15867 | 15867 | The current path as returned by many operating systems is a dangerous |
15868 | | - global variable. It might be changed unexpectedly by third-party or system |
| 15868 | + global variable and can be changed unexpectedly by third-party or system |
15869 | 15869 | library functions, or by another thread. |
15870 | 15870 | \end{note} |
15871 | 15871 | \end{itemdescr} |
|
15892 | 15892 | \pnum |
15893 | 15893 | \begin{note} |
15894 | 15894 | The current path for many operating systems is a dangerous |
15895 | | - global state. It might be changed unexpectedly by a third-party or system |
| 15895 | + global state and can be changed unexpectedly by third-party or system |
15896 | 15896 | library functions, or by another thread. |
15897 | 15897 | \end{note} |
15898 | 15898 | \end{itemdescr} |
|
16380 | 16380 |
|
16381 | 16381 | \pnum |
16382 | 16382 | \begin{note} |
16383 | | -A postcondition of \tcode{last_write_time(p) == new_time} is not specified since it might not hold for file systems |
16384 | | - with coarse time granularity. |
| 16383 | +A postcondition of \tcode{last_write_time(p) == new_time} is not specified |
| 16384 | +because it does not necessarily hold for file systems with coarse time granularity. |
16385 | 16385 | \end{note} |
16386 | 16386 | \end{itemdescr} |
16387 | 16387 |
|
|
0 commit comments