1 //===--- raw_ostream.cpp - Implement the raw_ostream classes --------------===// 2 // 3 // The LLVM Compiler Infrastructure 4 // 5 // This file is distributed under the University of Illinois Open Source 6 // License. See LICENSE.TXT for details. 7 // 8 //===----------------------------------------------------------------------===// 9 // 10 // This implements support for bulk buffered stream output. 11 // 12 //===----------------------------------------------------------------------===// 13 14 #include "llvm/Support/raw_ostream.h" 15 #include "llvm/ADT/STLExtras.h" 16 #include "llvm/ADT/SmallVector.h" 17 #include "llvm/ADT/StringExtras.h" 18 #include "llvm/Config/config.h" 19 #include "llvm/Support/Compiler.h" 20 #include "llvm/Support/ErrorHandling.h" 21 #include "llvm/Support/FileSystem.h" 22 #include "llvm/Support/Format.h" 23 #include "llvm/Support/MathExtras.h" 24 #include "llvm/Support/Process.h" 25 #include "llvm/Support/Program.h" 26 #include <cctype> 27 #include <cerrno> 28 #include <sys/stat.h> 29 #include <system_error> 30 31 // <fcntl.h> may provide O_BINARY. 32 #if defined(HAVE_FCNTL_H) 33 # include <fcntl.h> 34 #endif 35 36 #if defined(HAVE_UNISTD_H) 37 # include <unistd.h> 38 #endif 39 #if defined(HAVE_SYS_UIO_H) && defined(HAVE_WRITEV) 40 # include <sys/uio.h> 41 #endif 42 43 #if defined(__CYGWIN__) 44 #include <io.h> 45 #endif 46 47 #if defined(_MSC_VER) 48 #include <io.h> 49 #ifndef STDIN_FILENO 50 # define STDIN_FILENO 0 51 #endif 52 #ifndef STDOUT_FILENO 53 # define STDOUT_FILENO 1 54 #endif 55 #ifndef STDERR_FILENO 56 # define STDERR_FILENO 2 57 #endif 58 #endif 59 60 using namespace llvm; 61 62 raw_ostream::~raw_ostream() { 63 // raw_ostream's subclasses should take care to flush the buffer 64 // in their destructors. 65 assert(OutBufCur == OutBufStart && 66 "raw_ostream destructor called with non-empty buffer!"); 67 68 if (BufferMode == InternalBuffer) 69 delete [] OutBufStart; 70 } 71 72 // An out of line virtual method to provide a home for the class vtable. 73 void raw_ostream::handle() {} 74 75 size_t raw_ostream::preferred_buffer_size() const { 76 // BUFSIZ is intended to be a reasonable default. 77 return BUFSIZ; 78 } 79 80 void raw_ostream::SetBuffered() { 81 // Ask the subclass to determine an appropriate buffer size. 82 if (size_t Size = preferred_buffer_size()) 83 SetBufferSize(Size); 84 else 85 // It may return 0, meaning this stream should be unbuffered. 86 SetUnbuffered(); 87 } 88 89 void raw_ostream::SetBufferAndMode(char *BufferStart, size_t Size, 90 BufferKind Mode) { 91 assert(((Mode == Unbuffered && !BufferStart && Size == 0) || 92 (Mode != Unbuffered && BufferStart && Size != 0)) && 93 "stream must be unbuffered or have at least one byte"); 94 // Make sure the current buffer is free of content (we can't flush here; the 95 // child buffer management logic will be in write_impl). 96 assert(GetNumBytesInBuffer() == 0 && "Current buffer is non-empty!"); 97 98 if (BufferMode == InternalBuffer) 99 delete [] OutBufStart; 100 OutBufStart = BufferStart; 101 OutBufEnd = OutBufStart+Size; 102 OutBufCur = OutBufStart; 103 BufferMode = Mode; 104 105 assert(OutBufStart <= OutBufEnd && "Invalid size!"); 106 } 107 108 raw_ostream &raw_ostream::operator<<(unsigned long N) { 109 // Zero is a special case. 110 if (N == 0) 111 return *this << '0'; 112 113 char NumberBuffer[20]; 114 char *EndPtr = NumberBuffer+sizeof(NumberBuffer); 115 char *CurPtr = EndPtr; 116 117 while (N) { 118 *--CurPtr = '0' + char(N % 10); 119 N /= 10; 120 } 121 return write(CurPtr, EndPtr-CurPtr); 122 } 123 124 raw_ostream &raw_ostream::operator<<(long N) { 125 if (N < 0) { 126 *this << '-'; 127 // Avoid undefined behavior on LONG_MIN with a cast. 128 N = -(unsigned long)N; 129 } 130 131 return this->operator<<(static_cast<unsigned long>(N)); 132 } 133 134 raw_ostream &raw_ostream::operator<<(unsigned long long N) { 135 // Output using 32-bit div/mod when possible. 136 if (N == static_cast<unsigned long>(N)) 137 return this->operator<<(static_cast<unsigned long>(N)); 138 139 char NumberBuffer[20]; 140 char *EndPtr = NumberBuffer+sizeof(NumberBuffer); 141 char *CurPtr = EndPtr; 142 143 while (N) { 144 *--CurPtr = '0' + char(N % 10); 145 N /= 10; 146 } 147 return write(CurPtr, EndPtr-CurPtr); 148 } 149 150 raw_ostream &raw_ostream::operator<<(long long N) { 151 if (N < 0) { 152 *this << '-'; 153 // Avoid undefined behavior on INT64_MIN with a cast. 154 N = -(unsigned long long)N; 155 } 156 157 return this->operator<<(static_cast<unsigned long long>(N)); 158 } 159 160 raw_ostream &raw_ostream::write_hex(unsigned long long N) { 161 // Zero is a special case. 162 if (N == 0) 163 return *this << '0'; 164 165 char NumberBuffer[20]; 166 char *EndPtr = NumberBuffer+sizeof(NumberBuffer); 167 char *CurPtr = EndPtr; 168 169 while (N) { 170 uintptr_t x = N % 16; 171 *--CurPtr = (x < 10 ? '0' + x : 'a' + x - 10); 172 N /= 16; 173 } 174 175 return write(CurPtr, EndPtr-CurPtr); 176 } 177 178 raw_ostream &raw_ostream::write_escaped(StringRef Str, 179 bool UseHexEscapes) { 180 for (unsigned i = 0, e = Str.size(); i != e; ++i) { 181 unsigned char c = Str[i]; 182 183 switch (c) { 184 case '\\': 185 *this << '\\' << '\\'; 186 break; 187 case '\t': 188 *this << '\\' << 't'; 189 break; 190 case '\n': 191 *this << '\\' << 'n'; 192 break; 193 case '"': 194 *this << '\\' << '"'; 195 break; 196 default: 197 if (std::isprint(c)) { 198 *this << c; 199 break; 200 } 201 202 // Write out the escaped representation. 203 if (UseHexEscapes) { 204 *this << '\\' << 'x'; 205 *this << hexdigit((c >> 4 & 0xF)); 206 *this << hexdigit((c >> 0) & 0xF); 207 } else { 208 // Always use a full 3-character octal escape. 209 *this << '\\'; 210 *this << char('0' + ((c >> 6) & 7)); 211 *this << char('0' + ((c >> 3) & 7)); 212 *this << char('0' + ((c >> 0) & 7)); 213 } 214 } 215 } 216 217 return *this; 218 } 219 220 raw_ostream &raw_ostream::operator<<(const void *P) { 221 *this << '0' << 'x'; 222 223 return write_hex((uintptr_t) P); 224 } 225 226 raw_ostream &raw_ostream::operator<<(double N) { 227 #ifdef _WIN32 228 // On MSVCRT and compatible, output of %e is incompatible to Posix 229 // by default. Number of exponent digits should be at least 2. "%+03d" 230 // FIXME: Implement our formatter to here or Support/Format.h! 231 #if __cplusplus >= 201103L && defined(__MINGW32__) 232 // FIXME: It should be generic to C++11. 233 if (N == 0.0 && std::signbit(N)) 234 return *this << "-0.000000e+00"; 235 #else 236 int fpcl = _fpclass(N); 237 238 // negative zero 239 if (fpcl == _FPCLASS_NZ) 240 return *this << "-0.000000e+00"; 241 #endif 242 243 char buf[16]; 244 unsigned len; 245 len = format("%e", N).snprint(buf, sizeof(buf)); 246 if (len <= sizeof(buf) - 2) { 247 if (len >= 5 && buf[len - 5] == 'e' && buf[len - 3] == '0') { 248 int cs = buf[len - 4]; 249 if (cs == '+' || cs == '-') { 250 int c1 = buf[len - 2]; 251 int c0 = buf[len - 1]; 252 if (isdigit(static_cast<unsigned char>(c1)) && 253 isdigit(static_cast<unsigned char>(c0))) { 254 // Trim leading '0': "...e+012" -> "...e+12\0" 255 buf[len - 3] = c1; 256 buf[len - 2] = c0; 257 buf[--len] = 0; 258 } 259 } 260 } 261 return this->operator<<(buf); 262 } 263 #endif 264 return this->operator<<(format("%e", N)); 265 } 266 267 268 269 void raw_ostream::flush_nonempty() { 270 assert(OutBufCur > OutBufStart && "Invalid call to flush_nonempty."); 271 size_t Length = OutBufCur - OutBufStart; 272 OutBufCur = OutBufStart; 273 write_impl(OutBufStart, Length); 274 } 275 276 raw_ostream &raw_ostream::write(unsigned char C) { 277 // Group exceptional cases into a single branch. 278 if (LLVM_UNLIKELY(OutBufCur >= OutBufEnd)) { 279 if (LLVM_UNLIKELY(!OutBufStart)) { 280 if (BufferMode == Unbuffered) { 281 write_impl(reinterpret_cast<char*>(&C), 1); 282 return *this; 283 } 284 // Set up a buffer and start over. 285 SetBuffered(); 286 return write(C); 287 } 288 289 flush_nonempty(); 290 } 291 292 *OutBufCur++ = C; 293 return *this; 294 } 295 296 raw_ostream &raw_ostream::write(const char *Ptr, size_t Size) { 297 // Group exceptional cases into a single branch. 298 if (LLVM_UNLIKELY(size_t(OutBufEnd - OutBufCur) < Size)) { 299 if (LLVM_UNLIKELY(!OutBufStart)) { 300 if (BufferMode == Unbuffered) { 301 write_impl(Ptr, Size); 302 return *this; 303 } 304 // Set up a buffer and start over. 305 SetBuffered(); 306 return write(Ptr, Size); 307 } 308 309 size_t NumBytes = OutBufEnd - OutBufCur; 310 311 // If the buffer is empty at this point we have a string that is larger 312 // than the buffer. Directly write the chunk that is a multiple of the 313 // preferred buffer size and put the remainder in the buffer. 314 if (LLVM_UNLIKELY(OutBufCur == OutBufStart)) { 315 assert(NumBytes != 0 && "undefined behavior"); 316 size_t BytesToWrite = Size - (Size % NumBytes); 317 write_impl(Ptr, BytesToWrite); 318 size_t BytesRemaining = Size - BytesToWrite; 319 if (BytesRemaining > size_t(OutBufEnd - OutBufCur)) { 320 // Too much left over to copy into our buffer. 321 return write(Ptr + BytesToWrite, BytesRemaining); 322 } 323 copy_to_buffer(Ptr + BytesToWrite, BytesRemaining); 324 return *this; 325 } 326 327 // We don't have enough space in the buffer to fit the string in. Insert as 328 // much as possible, flush and start over with the remainder. 329 copy_to_buffer(Ptr, NumBytes); 330 flush_nonempty(); 331 return write(Ptr + NumBytes, Size - NumBytes); 332 } 333 334 copy_to_buffer(Ptr, Size); 335 336 return *this; 337 } 338 339 void raw_ostream::copy_to_buffer(const char *Ptr, size_t Size) { 340 assert(Size <= size_t(OutBufEnd - OutBufCur) && "Buffer overrun!"); 341 342 // Handle short strings specially, memcpy isn't very good at very short 343 // strings. 344 switch (Size) { 345 case 4: OutBufCur[3] = Ptr[3]; // FALL THROUGH 346 case 3: OutBufCur[2] = Ptr[2]; // FALL THROUGH 347 case 2: OutBufCur[1] = Ptr[1]; // FALL THROUGH 348 case 1: OutBufCur[0] = Ptr[0]; // FALL THROUGH 349 case 0: break; 350 default: 351 memcpy(OutBufCur, Ptr, Size); 352 break; 353 } 354 355 OutBufCur += Size; 356 } 357 358 // Formatted output. 359 raw_ostream &raw_ostream::operator<<(const format_object_base &Fmt) { 360 // If we have more than a few bytes left in our output buffer, try 361 // formatting directly onto its end. 362 size_t NextBufferSize = 127; 363 size_t BufferBytesLeft = OutBufEnd - OutBufCur; 364 if (BufferBytesLeft > 3) { 365 size_t BytesUsed = Fmt.print(OutBufCur, BufferBytesLeft); 366 367 // Common case is that we have plenty of space. 368 if (BytesUsed <= BufferBytesLeft) { 369 OutBufCur += BytesUsed; 370 return *this; 371 } 372 373 // Otherwise, we overflowed and the return value tells us the size to try 374 // again with. 375 NextBufferSize = BytesUsed; 376 } 377 378 // If we got here, we didn't have enough space in the output buffer for the 379 // string. Try printing into a SmallVector that is resized to have enough 380 // space. Iterate until we win. 381 SmallVector<char, 128> V; 382 383 while (1) { 384 V.resize(NextBufferSize); 385 386 // Try formatting into the SmallVector. 387 size_t BytesUsed = Fmt.print(V.data(), NextBufferSize); 388 389 // If BytesUsed fit into the vector, we win. 390 if (BytesUsed <= NextBufferSize) 391 return write(V.data(), BytesUsed); 392 393 // Otherwise, try again with a new size. 394 assert(BytesUsed > NextBufferSize && "Didn't grow buffer!?"); 395 NextBufferSize = BytesUsed; 396 } 397 } 398 399 raw_ostream &raw_ostream::operator<<(const FormattedString &FS) { 400 unsigned Len = FS.Str.size(); 401 int PadAmount = FS.Width - Len; 402 if (FS.RightJustify && (PadAmount > 0)) 403 this->indent(PadAmount); 404 this->operator<<(FS.Str); 405 if (!FS.RightJustify && (PadAmount > 0)) 406 this->indent(PadAmount); 407 return *this; 408 } 409 410 raw_ostream &raw_ostream::operator<<(const FormattedNumber &FN) { 411 if (FN.Hex) { 412 unsigned Nibbles = (64 - countLeadingZeros(FN.HexValue)+3)/4; 413 unsigned PrefixChars = FN.HexPrefix ? 2 : 0; 414 unsigned Width = std::max(FN.Width, Nibbles + PrefixChars); 415 416 char NumberBuffer[20] = "0x0000000000000000"; 417 if (!FN.HexPrefix) 418 NumberBuffer[1] = '0'; 419 char *EndPtr = NumberBuffer+Width; 420 char *CurPtr = EndPtr; 421 const char A = FN.Upper ? 'A' : 'a'; 422 unsigned long long N = FN.HexValue; 423 while (N) { 424 uintptr_t x = N % 16; 425 *--CurPtr = (x < 10 ? '0' + x : A + x - 10); 426 N /= 16; 427 } 428 429 return write(NumberBuffer, Width); 430 } else { 431 // Zero is a special case. 432 if (FN.DecValue == 0) { 433 this->indent(FN.Width-1); 434 return *this << '0'; 435 } 436 char NumberBuffer[32]; 437 char *EndPtr = NumberBuffer+sizeof(NumberBuffer); 438 char *CurPtr = EndPtr; 439 bool Neg = (FN.DecValue < 0); 440 uint64_t N = Neg ? -static_cast<uint64_t>(FN.DecValue) : FN.DecValue; 441 while (N) { 442 *--CurPtr = '0' + char(N % 10); 443 N /= 10; 444 } 445 int Len = EndPtr - CurPtr; 446 int Pad = FN.Width - Len; 447 if (Neg) 448 --Pad; 449 if (Pad > 0) 450 this->indent(Pad); 451 if (Neg) 452 *this << '-'; 453 return write(CurPtr, Len); 454 } 455 } 456 457 458 /// indent - Insert 'NumSpaces' spaces. 459 raw_ostream &raw_ostream::indent(unsigned NumSpaces) { 460 static const char Spaces[] = " " 461 " " 462 " "; 463 464 // Usually the indentation is small, handle it with a fastpath. 465 if (NumSpaces < array_lengthof(Spaces)) 466 return write(Spaces, NumSpaces); 467 468 while (NumSpaces) { 469 unsigned NumToWrite = std::min(NumSpaces, 470 (unsigned)array_lengthof(Spaces)-1); 471 write(Spaces, NumToWrite); 472 NumSpaces -= NumToWrite; 473 } 474 return *this; 475 } 476 477 478 //===----------------------------------------------------------------------===// 479 // Formatted Output 480 //===----------------------------------------------------------------------===// 481 482 // Out of line virtual method. 483 void format_object_base::home() { 484 } 485 486 //===----------------------------------------------------------------------===// 487 // raw_fd_ostream 488 //===----------------------------------------------------------------------===// 489 490 raw_fd_ostream::raw_fd_ostream(StringRef Filename, std::error_code &EC, 491 sys::fs::OpenFlags Flags) 492 : Error(false), UseAtomicWrites(false), pos(0) { 493 EC = std::error_code(); 494 // Handle "-" as stdout. Note that when we do this, we consider ourself 495 // the owner of stdout. This means that we can do things like close the 496 // file descriptor when we're done and set the "binary" flag globally. 497 if (Filename == "-") { 498 FD = STDOUT_FILENO; 499 // If user requested binary then put stdout into binary mode if 500 // possible. 501 if (!(Flags & sys::fs::F_Text)) 502 sys::ChangeStdoutToBinary(); 503 // Close stdout when we're done, to detect any output errors. 504 ShouldClose = true; 505 return; 506 } 507 508 EC = sys::fs::openFileForWrite(Filename, FD, Flags); 509 510 if (EC) { 511 ShouldClose = false; 512 return; 513 } 514 515 // Ok, we successfully opened the file, so it'll need to be closed. 516 ShouldClose = true; 517 } 518 519 /// raw_fd_ostream ctor - FD is the file descriptor that this writes to. If 520 /// ShouldClose is true, this closes the file when the stream is destroyed. 521 raw_fd_ostream::raw_fd_ostream(int fd, bool shouldClose, bool unbuffered) 522 : raw_ostream(unbuffered), FD(fd), 523 ShouldClose(shouldClose), Error(false), UseAtomicWrites(false) { 524 #ifdef O_BINARY 525 // Setting STDOUT to binary mode is necessary in Win32 526 // to avoid undesirable linefeed conversion. 527 // Don't touch STDERR, or w*printf() (in assert()) would barf wide chars. 528 if (fd == STDOUT_FILENO) 529 setmode(fd, O_BINARY); 530 #endif 531 532 // Get the starting position. 533 off_t loc = ::lseek(FD, 0, SEEK_CUR); 534 if (loc == (off_t)-1) 535 pos = 0; 536 else 537 pos = static_cast<uint64_t>(loc); 538 } 539 540 raw_fd_ostream::~raw_fd_ostream() { 541 if (FD >= 0) { 542 flush(); 543 if (ShouldClose && sys::Process::SafelyCloseFileDescriptor(FD)) 544 error_detected(); 545 } 546 547 #ifdef __MINGW32__ 548 // On mingw, global dtors should not call exit(). 549 // report_fatal_error() invokes exit(). We know report_fatal_error() 550 // might not write messages to stderr when any errors were detected 551 // on FD == 2. 552 if (FD == 2) return; 553 #endif 554 555 // If there are any pending errors, report them now. Clients wishing 556 // to avoid report_fatal_error calls should check for errors with 557 // has_error() and clear the error flag with clear_error() before 558 // destructing raw_ostream objects which may have errors. 559 if (has_error()) 560 report_fatal_error("IO failure on output stream.", /*GenCrashDiag=*/false); 561 } 562 563 564 void raw_fd_ostream::write_impl(const char *Ptr, size_t Size) { 565 assert(FD >= 0 && "File already closed."); 566 pos += Size; 567 568 do { 569 ssize_t ret; 570 571 // Check whether we should attempt to use atomic writes. 572 if (LLVM_LIKELY(!UseAtomicWrites)) { 573 ret = ::write(FD, Ptr, Size); 574 } else { 575 // Use ::writev() where available. 576 #if defined(HAVE_WRITEV) 577 const void *Addr = static_cast<const void *>(Ptr); 578 struct iovec IOV = {const_cast<void *>(Addr), Size }; 579 ret = ::writev(FD, &IOV, 1); 580 #else 581 ret = ::write(FD, Ptr, Size); 582 #endif 583 } 584 585 if (ret < 0) { 586 // If it's a recoverable error, swallow it and retry the write. 587 // 588 // Ideally we wouldn't ever see EAGAIN or EWOULDBLOCK here, since 589 // raw_ostream isn't designed to do non-blocking I/O. However, some 590 // programs, such as old versions of bjam, have mistakenly used 591 // O_NONBLOCK. For compatibility, emulate blocking semantics by 592 // spinning until the write succeeds. If you don't want spinning, 593 // don't use O_NONBLOCK file descriptors with raw_ostream. 594 if (errno == EINTR || errno == EAGAIN 595 #ifdef EWOULDBLOCK 596 || errno == EWOULDBLOCK 597 #endif 598 ) 599 continue; 600 601 // Otherwise it's a non-recoverable error. Note it and quit. 602 error_detected(); 603 break; 604 } 605 606 // The write may have written some or all of the data. Update the 607 // size and buffer pointer to reflect the remainder that needs 608 // to be written. If there are no bytes left, we're done. 609 Ptr += ret; 610 Size -= ret; 611 } while (Size > 0); 612 } 613 614 void raw_fd_ostream::close() { 615 assert(ShouldClose); 616 ShouldClose = false; 617 flush(); 618 if (sys::Process::SafelyCloseFileDescriptor(FD)) 619 error_detected(); 620 FD = -1; 621 } 622 623 uint64_t raw_fd_ostream::seek(uint64_t off) { 624 flush(); 625 pos = ::lseek(FD, off, SEEK_SET); 626 if (pos != off) 627 error_detected(); 628 return pos; 629 } 630 631 size_t raw_fd_ostream::preferred_buffer_size() const { 632 #if !defined(_MSC_VER) && !defined(__MINGW32__) && !defined(__minix) 633 // Windows and Minix have no st_blksize. 634 assert(FD >= 0 && "File not yet open!"); 635 struct stat statbuf; 636 if (fstat(FD, &statbuf) != 0) 637 return 0; 638 639 // If this is a terminal, don't use buffering. Line buffering 640 // would be a more traditional thing to do, but it's not worth 641 // the complexity. 642 if (S_ISCHR(statbuf.st_mode) && isatty(FD)) 643 return 0; 644 // Return the preferred block size. 645 return statbuf.st_blksize; 646 #else 647 return raw_ostream::preferred_buffer_size(); 648 #endif 649 } 650 651 raw_ostream &raw_fd_ostream::changeColor(enum Colors colors, bool bold, 652 bool bg) { 653 if (sys::Process::ColorNeedsFlush()) 654 flush(); 655 const char *colorcode = 656 (colors == SAVEDCOLOR) ? sys::Process::OutputBold(bg) 657 : sys::Process::OutputColor(colors, bold, bg); 658 if (colorcode) { 659 size_t len = strlen(colorcode); 660 write(colorcode, len); 661 // don't account colors towards output characters 662 pos -= len; 663 } 664 return *this; 665 } 666 667 raw_ostream &raw_fd_ostream::resetColor() { 668 if (sys::Process::ColorNeedsFlush()) 669 flush(); 670 const char *colorcode = sys::Process::ResetColor(); 671 if (colorcode) { 672 size_t len = strlen(colorcode); 673 write(colorcode, len); 674 // don't account colors towards output characters 675 pos -= len; 676 } 677 return *this; 678 } 679 680 raw_ostream &raw_fd_ostream::reverseColor() { 681 if (sys::Process::ColorNeedsFlush()) 682 flush(); 683 const char *colorcode = sys::Process::OutputReverse(); 684 if (colorcode) { 685 size_t len = strlen(colorcode); 686 write(colorcode, len); 687 // don't account colors towards output characters 688 pos -= len; 689 } 690 return *this; 691 } 692 693 bool raw_fd_ostream::is_displayed() const { 694 return sys::Process::FileDescriptorIsDisplayed(FD); 695 } 696 697 bool raw_fd_ostream::has_colors() const { 698 return sys::Process::FileDescriptorHasColors(FD); 699 } 700 701 //===----------------------------------------------------------------------===// 702 // outs(), errs(), nulls() 703 //===----------------------------------------------------------------------===// 704 705 /// outs() - This returns a reference to a raw_ostream for standard output. 706 /// Use it like: outs() << "foo" << "bar"; 707 raw_ostream &llvm::outs() { 708 // Set buffer settings to model stdout behavior. 709 // Delete the file descriptor when the program exits, forcing error 710 // detection. If you don't want this behavior, don't use outs(). 711 static raw_fd_ostream S(STDOUT_FILENO, true); 712 return S; 713 } 714 715 /// errs() - This returns a reference to a raw_ostream for standard error. 716 /// Use it like: errs() << "foo" << "bar"; 717 raw_ostream &llvm::errs() { 718 // Set standard error to be unbuffered by default. 719 static raw_fd_ostream S(STDERR_FILENO, false, true); 720 return S; 721 } 722 723 /// nulls() - This returns a reference to a raw_ostream which discards output. 724 raw_ostream &llvm::nulls() { 725 static raw_null_ostream S; 726 return S; 727 } 728 729 730 //===----------------------------------------------------------------------===// 731 // raw_string_ostream 732 //===----------------------------------------------------------------------===// 733 734 raw_string_ostream::~raw_string_ostream() { 735 flush(); 736 } 737 738 void raw_string_ostream::write_impl(const char *Ptr, size_t Size) { 739 OS.append(Ptr, Size); 740 } 741 742 //===----------------------------------------------------------------------===// 743 // raw_svector_ostream 744 //===----------------------------------------------------------------------===// 745 746 // The raw_svector_ostream implementation uses the SmallVector itself as the 747 // buffer for the raw_ostream. We guarantee that the raw_ostream buffer is 748 // always pointing past the end of the vector, but within the vector 749 // capacity. This allows raw_ostream to write directly into the correct place, 750 // and we only need to set the vector size when the data is flushed. 751 752 raw_svector_ostream::raw_svector_ostream(SmallVectorImpl<char> &O) : OS(O) { 753 // Set up the initial external buffer. We make sure that the buffer has at 754 // least 128 bytes free; raw_ostream itself only requires 64, but we want to 755 // make sure that we don't grow the buffer unnecessarily on destruction (when 756 // the data is flushed). See the FIXME below. 757 OS.reserve(OS.size() + 128); 758 SetBuffer(OS.end(), OS.capacity() - OS.size()); 759 } 760 761 raw_svector_ostream::~raw_svector_ostream() { 762 // FIXME: Prevent resizing during this flush(). 763 flush(); 764 } 765 766 /// resync - This is called when the SmallVector we're appending to is changed 767 /// outside of the raw_svector_ostream's control. It is only safe to do this 768 /// if the raw_svector_ostream has previously been flushed. 769 void raw_svector_ostream::resync() { 770 assert(GetNumBytesInBuffer() == 0 && "Didn't flush before mutating vector"); 771 772 if (OS.capacity() - OS.size() < 64) 773 OS.reserve(OS.capacity() * 2); 774 SetBuffer(OS.end(), OS.capacity() - OS.size()); 775 } 776 777 void raw_svector_ostream::write_impl(const char *Ptr, size_t Size) { 778 if (Ptr == OS.end()) { 779 // Grow the buffer to include the scratch area without copying. 780 size_t NewSize = OS.size() + Size; 781 assert(NewSize <= OS.capacity() && "Invalid write_impl() call!"); 782 OS.set_size(NewSize); 783 } else { 784 assert(!GetNumBytesInBuffer()); 785 OS.append(Ptr, Ptr + Size); 786 } 787 788 OS.reserve(OS.size() + 64); 789 SetBuffer(OS.end(), OS.capacity() - OS.size()); 790 } 791 792 uint64_t raw_svector_ostream::current_pos() const { 793 return OS.size(); 794 } 795 796 StringRef raw_svector_ostream::str() { 797 flush(); 798 return StringRef(OS.begin(), OS.size()); 799 } 800 801 //===----------------------------------------------------------------------===// 802 // raw_null_ostream 803 //===----------------------------------------------------------------------===// 804 805 raw_null_ostream::~raw_null_ostream() { 806 #ifndef NDEBUG 807 // ~raw_ostream asserts that the buffer is empty. This isn't necessary 808 // with raw_null_ostream, but it's better to have raw_null_ostream follow 809 // the rules than to change the rules just for raw_null_ostream. 810 flush(); 811 #endif 812 } 813 814 void raw_null_ostream::write_impl(const char *Ptr, size_t Size) { 815 } 816 817 uint64_t raw_null_ostream::current_pos() const { 818 return 0; 819 } 820