SI2ToScaledString(Int64, String, String, Int64, Int64) Method

Turns the given number of units (e.g., bytes) into a textual representation with an appropriate unit scaling and common named representation (e.g., KB, MB, GB, TB, etc.).

Definition

Namespace: Gemstone.Units
Assembly: Gemstone.Common (in Gemstone.Common.dll) Version: 1.0.110 -- Release Build+3e0464f4461df4d3e1175b13966eb47ff832554d

C#View Source Request Example

public static string ToScaledString(
	long totalUnits,
	string format,
	string unitName,
	long minimumFactor = 1024,
	long maximumFactor = 1152921504606846976
)

VBView Source Request Example

Public Shared Function ToScaledString ( 
	totalUnits As Long,
	format As String,
	unitName As String,
	Optional minimumFactor As Long = 1024,
	Optional maximumFactor As Long = 1152921504606846976
) As String

C++View Source Request Example

public:
static String^ ToScaledString(
	long long totalUnits, 
	String^ format, 
	String^ unitName, 
	long long minimumFactor = 1024, 
	long long maximumFactor = 1152921504606846976
)

JavaScriptView Source Request Example

Gemstone.Units.SI2.ToScaledString = function(totalUnits, format, unitName, minimumFactor, maximumFactor);

Parameters

totalUnits Int64: Total units to represent textually.
format String: A numeric string format for scaled totalUnits.
unitName String: Name of unit display (e.g., you could use "B" for bytes).
minimumFactor Int64 (Optional): Optional minimum SI factor. Defaults to Kilo.
maximumFactor Int64 (Optional): Optional maximum SI factor. Defaults to Exa.

Return Value

String
A String representation of the number of units.

Remarks

Symbols array is used for displaying SI symbol prefix for unitName.

Exceptions

ArgumentOutOfRangeException

minimumFactor or maximumFactor is not defined in Factors array.