For this function what would be a best way to describe what it does at the top.

Example:// This function will....

void function();

47 std::string:: const_iterator refillBuffer(std::string:: const_iterator pc, std::string& buffer, long& totalBytes) { 48 49 // find number of unprocessed characters [PC, buffer.cend() auto d = std::distance(pc, buffer.cend()); 51 52 // move unprocessed characters, [PC, buffer.cend(), to start of the buffer std::copy(PC, buffer.cend(), buffer.begin(); 53 54 55 56 57 (ssize_t) -1) && 58 59 69 // read in trying to read whole blocks ssize_t numbytes while (((numbytes READ(@, (void) (buffer.data() + d), (size_t) (BUFFER_SIZE - d))) (errno EINTR)) { } 11 error in read if (numbytes == -1) return buffer.cend(); // EOF if (numbytes return buffer.cend(); 61 62 63 64 65 66 if ((std::string:: size_type) (numbytes + d)