folly/String.cpp

   1 /*
   2  * Copyright 2014 Facebook, Inc.
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *   http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 #include "folly/String.h"
  18 #include "folly/Format.h"
  19
  20 #include <cerrno>
  21 #include <cstdarg>
  22 #include <cstring>
  23 #include <stdexcept>
  24 #include <iterator>
  25 #include <glog/logging.h>
  26
  27 namespace folly {
  28
  29 namespace {
  30
  31 inline void stringPrintfImpl(std::string& output, const char* format,
  32                              va_list args) {
  33   // Tru to the space at the end of output for our output buffer.
  34   // Find out write point then inflate its size temporarily to its
  35   // capacity; we will later shrink it to the size needed to represent
  36   // the formatted string.  If this buffer isn't large enough, we do a
  37   // resize and try again.
  38
  39   const auto write_point = output.size();
  40   auto remaining = output.capacity() - write_point;
  41   output.resize(output.capacity());
  42
  43   va_list args_copy;
  44   va_copy(args_copy, args);
  45   int bytes_used = vsnprintf(&output[write_point], remaining, format,
  46                              args_copy);
  47   va_end(args_copy);
  48   if (bytes_used < 0) {
  49     throw std::runtime_error(
  50       to<std::string>("Invalid format string; snprintf returned negative "
  51                       "with format string: ", format));
  52   } else if (bytes_used < remaining) {
  53     // There was enough room, just shrink and return.
  54     output.resize(write_point + bytes_used);
  55   } else {
  56     output.resize(write_point + bytes_used + 1);
  57     remaining = bytes_used + 1;
  58     va_list args_copy;
  59     va_copy(args_copy, args);
  60     bytes_used = vsnprintf(&output[write_point], remaining, format,
  61                            args_copy);
  62     va_end(args_copy);
  63     if (bytes_used + 1 != remaining) {
  64       throw std::runtime_error(
  65         to<std::string>("vsnprint retry did not manage to work "
  66                         "with format string: ", format));
  67     }
  68     output.resize(write_point + bytes_used);
  69   }
  70 }
  71
  72 }  // anon namespace
  73
  74 std::string stringPrintf(const char* format, ...) {
  75   // snprintf will tell us how large the output buffer should be, but
  76   // we then have to call it a second time, which is costly.  By
  77   // guestimating the final size, we avoid the double snprintf in many
  78   // cases, resulting in a performance win.  We use this constructor
  79   // of std::string to avoid a double allocation, though it does pad
  80   // the resulting string with nul bytes.  Our guestimation is twice
  81   // the format string size, or 32 bytes, whichever is larger.  This
  82   // is a hueristic that doesn't affect correctness but attempts to be
  83   // reasonably fast for the most common cases.
  84   std::string ret(std::max(32UL, strlen(format) * 2), '\0');
  85   ret.resize(0);
  86
  87   va_list ap;
  88   va_start(ap, format);
  89   stringPrintfImpl(ret, format, ap);
  90   va_end(ap);
  91   return ret;
  92 }
  93
  94 // Basic declarations; allow for parameters of strings and string
  95 // pieces to be specified.
  96 std::string& stringAppendf(std::string* output, const char* format, ...) {
  97   va_list ap;
  98   va_start(ap, format);
  99   stringPrintfImpl(*output, format, ap);
 100   va_end(ap);
 101   return *output;
 102 }
 103
 104 void stringPrintf(std::string* output, const char* format, ...) {
 105   output->clear();
 106   va_list ap;
 107   va_start(ap, format);
 108   stringPrintfImpl(*output, format, ap);
 109   va_end(ap);
 110 };
 111
 112 namespace {
 113
 114 struct PrettySuffix {
 115   const char* suffix;
 116   double val;
 117 };
 118
 119 const PrettySuffix kPrettyTimeSuffixes[] = {
 120   { "s ", 1e0L },
 121   { "ms", 1e-3L },
 122   { "us", 1e-6L },
 123   { "ns", 1e-9L },
 124   { "ps", 1e-12L },
 125   { "s ", 0 },
 126   { 0, 0 },
 127 };
 128
 129 const PrettySuffix kPrettyBytesMetricSuffixes[] = {
 130   { "TB", 1e12L },
 131   { "GB", 1e9L },
 132   { "MB", 1e6L },
 133   { "kB", 1e3L },
 134   { "B ", 0L },
 135   { 0, 0 },
 136 };
 137
 138 const PrettySuffix kPrettyBytesBinarySuffixes[] = {
 139   { "TB", int64_t(1) << 40 },
 140   { "GB", int64_t(1) << 30 },
 141   { "MB", int64_t(1) << 20 },
 142   { "kB", int64_t(1) << 10 },
 143   { "B ", 0L },
 144   { 0, 0 },
 145 };
 146
 147 const PrettySuffix kPrettyBytesBinaryIECSuffixes[] = {
 148   { "TiB", int64_t(1) << 40 },
 149   { "GiB", int64_t(1) << 30 },
 150   { "MiB", int64_t(1) << 20 },
 151   { "KiB", int64_t(1) << 10 },
 152   { "B  ", 0L },
 153   { 0, 0 },
 154 };
 155
 156 const PrettySuffix kPrettyUnitsMetricSuffixes[] = {
 157   { "tril", 1e12L },
 158   { "bil",  1e9L },
 159   { "M",    1e6L },
 160   { "k",    1e3L },
 161   { " ",      0  },
 162   { 0, 0 },
 163 };
 164
 165 const PrettySuffix kPrettyUnitsBinarySuffixes[] = {
 166   { "T", int64_t(1) << 40 },
 167   { "G", int64_t(1) << 30 },
 168   { "M", int64_t(1) << 20 },
 169   { "k", int64_t(1) << 10 },
 170   { " ", 0 },
 171   { 0, 0 },
 172 };
 173
 174 const PrettySuffix kPrettyUnitsBinaryIECSuffixes[] = {
 175   { "Ti", int64_t(1) << 40 },
 176   { "Gi", int64_t(1) << 30 },
 177   { "Mi", int64_t(1) << 20 },
 178   { "Ki", int64_t(1) << 10 },
 179   { "  ", 0 },
 180   { 0, 0 },
 181 };
 182
 183 const PrettySuffix* const kPrettySuffixes[PRETTY_NUM_TYPES] = {
 184   kPrettyTimeSuffixes,
 185   kPrettyBytesMetricSuffixes,
 186   kPrettyBytesBinarySuffixes,
 187   kPrettyBytesBinaryIECSuffixes,
 188   kPrettyUnitsMetricSuffixes,
 189   kPrettyUnitsBinarySuffixes,
 190   kPrettyUnitsBinaryIECSuffixes,
 191 };
 192
 193 }  // namespace
 194
 195 std::string prettyPrint(double val, PrettyType type, bool addSpace) {
 196   char buf[100];
 197
 198   // pick the suffixes to use
 199   assert(type >= 0);
 200   assert(type < PRETTY_NUM_TYPES);
 201   const PrettySuffix* suffixes = kPrettySuffixes[type];
 202
 203   // find the first suffix we're bigger than -- then use it
 204   double abs_val = fabs(val);
 205   for (int i = 0; suffixes[i].suffix; ++i) {
 206     if (abs_val >= suffixes[i].val) {
 207       snprintf(buf, sizeof buf, "%.4g%s%s",
 208                (suffixes[i].val ? (val / suffixes[i].val)
 209                                 : val),
 210                (addSpace ? " " : ""),
 211                suffixes[i].suffix);
 212       return std::string(buf);
 213     }
 214   }
 215
 216   // no suffix, we've got a tiny value -- just print it in sci-notation
 217   snprintf(buf, sizeof buf, "%.4g", val);
 218   return std::string(buf);
 219 }
 220
 221 std::string hexDump(const void* ptr, size_t size) {
 222   std::ostringstream os;
 223   hexDump(ptr, size, std::ostream_iterator<StringPiece>(os, "\n"));
 224   return os.str();
 225 }
 226
 227 fbstring errnoStr(int err) {
 228   int savedErrno = errno;
 229
 230   // Ensure that we reset errno upon exit.
 231   auto guard(makeGuard([&] { errno = savedErrno; }));
 232
 233   char buf[1024];
 234   buf[0] = '\0';
 235
 236   fbstring result;
 237
 238   // https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man3/strerror_r.3.html
 239   // http://www.kernel.org/doc/man-pages/online/pages/man3/strerror.3.html
 240 #if defined(__APPLE__) || defined(__FreeBSD__) || \
 241     ((_POSIX_C_SOURCE >= 200112L || _XOPEN_SOURCE >= 600) && !_GNU_SOURCE)
 242   // Using XSI-compatible strerror_r
 243   int r = strerror_r(err, buf, sizeof(buf));
 244
 245   // OSX/FreeBSD use EINVAL and Linux uses -1 so just check for non-zero
 246   if (r != 0) {
 247     result = to<fbstring>(
 248       "Unknown error ", err,
 249       " (strerror_r failed with error ", errno, ")");
 250   } else {
 251     result.assign(buf);
 252   }
 253 #else
 254   // Using GNU strerror_r
 255   result.assign(strerror_r(err, buf, sizeof(buf)));
 256 #endif
 257
 258   return result;
 259 }
 260
 261 namespace detail {
 262
 263 size_t hexDumpLine(const void* ptr, size_t offset, size_t size,
 264                    std::string& line) {
 265   // Line layout:
 266   // 8: address
 267   // 1: space
 268   // (1+2)*16: hex bytes, each preceded by a space
 269   // 1: space separating the two halves
 270   // 3: "  |"
 271   // 16: characters
 272   // 1: "|"
 273   // Total: 78
 274   line.clear();
 275   line.reserve(78);
 276   const uint8_t* p = reinterpret_cast<const uint8_t*>(ptr) + offset;
 277   size_t n = std::min(size - offset, size_t(16));
 278   format("{:08x} ", offset).appendTo(line);
 279
 280   for (size_t i = 0; i < n; i++) {
 281     if (i == 8) {
 282       line.push_back(' ');
 283     }
 284     format(" {:02x}", p[i]).appendTo(line);
 285   }
 286
 287   // 3 spaces for each byte we're not printing, one separating the halves
 288   // if necessary
 289   line.append(3 * (16 - n) + (n <= 8), ' ');
 290   line.append("  |");
 291
 292   for (size_t i = 0; i < n; i++) {
 293     char c = (p[i] >= 32 && p[i] <= 126 ? static_cast<char>(p[i]) : '.');
 294     line.push_back(c);
 295   }
 296   line.append(16 - n, ' ');
 297   line.push_back('|');
 298   DCHECK_EQ(line.size(), 78);
 299
 300   return n;
 301 }
 302
 303 } // namespace detail
 304
 305 }   // namespace folly
 306
 307 #ifdef FOLLY_DEFINED_DMGL
 308 # undef FOLLY_DEFINED_DMGL
 309 # undef DMGL_NO_OPTS
 310 # undef DMGL_PARAMS
 311 # undef DMGL_ANSI
 312 # undef DMGL_JAVA
 313 # undef DMGL_VERBOSE
 314 # undef DMGL_TYPES
 315 # undef DMGL_RET_POSTFIX
 316 #endif
 317