File: xsputn.yo

package info (click to toggle)
c%2B%2B-annotations 13.02.02-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 13,576 kB
  • sloc: cpp: 25,297; makefile: 1,523; ansic: 165; sh: 126; perl: 90; fortran: 27
file content (21 lines) | stat: -rw-r--r-- 1,091 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
A stream's tt(write) member calls tt(xputn) to write tt(nChars) characters
into the device. As with tt(xsgetn) the tt(nChar) characters might not be
available in the current buffer. In those cases tt(overflow) is called to
refresh the buffer. Room for some bytes may still be available, and at each
cycle the number of available locations are copied from the member's tt(buf)
parameter to the tt(streambuf's) write buffer, calling tt(overflow) if there's
no space available anymore in the current write buffer. So tt(xsputn), while
there are (still) characters to be written to the device, must
    itemization(
    it() determine whether the current buffer contains some space;
    it() if not, it must call tt(overflow);
    it() the number of available characters are copied to the device's 
        write-buffer;
    it() the number of bytes to write is reduced by the number of available
        bytes; 
    it() the tt(buf) pointer and the counters are updated using the
        number of written bytes. 
    )

Here is a skeleton of tt(xsputn):
    verbinclude(-a examples/xsputn.cc)