Localize strings, speeds.

ui/base/text/bytes_formatting.h

+// Copyright (c) 2011 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+#ifndef UI_BASE_TEXT_BYTES_FORMATTING_H_
+#define UI_BASE_TEXT_BYTES_FORMATTING_H_
+#pragma once
+
+#include "base/basictypes.h"
+#include "base/string16.h"
+
+namespace ui {
+
+// Simple API ------------------------------------------------------------------
+
+// Simple call to return a byte quantity as a string in human-readable format.
+// Ex: FormatBytes(512) => "512 B"
+// Ex: FormatBytes(101479) => "99.1 kB"
+string16 FormatBytes(int64 bytes);
+
+// Simple call to return a speed as a string in human-readable format.
+// Ex: FormatSpeed(512) => "512 B/s"
+// Ex: FormatSpeed(101479) => "99.1 kB/s"
+string16 FormatSpeed(int64 bytes);
+
+// Less-Simple API -------------------------------------------------------------
+
+enum DataUnits {
+  DATA_UNITS_BYTE = 0,
+  DATA_UNITS_KIBIBYTE,
+  DATA_UNITS_MEBIBYTE,
+  DATA_UNITS_GIBIBYTE,
+  DATA_UNITS_TEBIBYTE,
+  DATA_UNITS_PEBIBYTE
+};
+
+// Return the unit type that is appropriate for displaying the amount of bytes
+// passed in. Most of the time, an explicit call to this isn't necessary; just
+// use FormatBytes()/FormatSpeed() above.
+DataUnits GetByteDisplayUnits(int64 bytes);
+
+// Return a byte quantity as a string in human-readable format with an optional
+// unit suffix. Specify in the |units| argument the units to be used.
+// Ex: FormatBytes(512, DATA_UNITS_KIBIBYTE, true) => "0.5 kB"
+// Ex: FormatBytes(10*1024, DATA_UNITS_MEBIBYTE, false) => "0.1"
+string16 FormatBytesWithUnits(int64 bytes, DataUnits units, bool show_units);
+
+// As above, but with "/s" units for speed values.
+// Ex: FormatSpeed(512, DATA_UNITS_KIBIBYTE, true) => "0.5 kB/s"
+// Ex: FormatSpeed(10*1024, DATA_UNITS_MEBIBYTE, false) => "0.1"
+string16 FormatSpeedWithUnits(int64 bytes, DataUnits units, bool show_units);
+
+}  // namespace ui
+
+#endif  // UI_BASE_TEXT_BYTES_FORMATTING_H_