org.apache.flink.configuration

Class MemorySize

java.lang.Object

org.apache.flink.configuration.MemorySize

All Implemented Interfaces:

Serializable

@PublicEvolving
public class MemorySize
extends Object
implements Serializable

MemorySize is a representation of a number of bytes, viewable in different units.

Parsing

The size can be parsed from a text expression. If the expression is a pure number, the value will be interpreted as bytes.

To make larger values more compact, the common size suffixes are supported:

• q or 1b or 1bytes (bytes)
• 1k or 1kb or 1kibibytes (interpreted as kibibytes = 1024 bytes)
• 1m or 1mb or 1mebibytes (interpreted as mebibytes = 1024 kibibytes)
• 1g or 1gb or 1gibibytes (interpreted as gibibytes = 1024 mebibytes)
• 1t or 1tb or 1tebibytes (interpreted as tebibytes = 1024 gibibytes)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
MemorySize(long bytes) Constructs a new MemorySize.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
long	getBytes() Gets the memory size in bytes.
long	getGibiBytes() Gets the memory size in Gibibytes (= 1024 Mebibytes).
long	getKibiBytes() Gets the memory size in Kibibytes (= 1024 bytes).
long	getMebiBytes() Gets the memory size in Mebibytes (= 1024 Kibibytes).
long	getTebiBytes() Gets the memory size in Tebibytes (= 1024 Gibibytes).
int	hashCode()
static MemorySize	parse(String text) Parses the given string as as MemorySize.
static long	parseBytes(String text) Parses the given string as bytes.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

MemorySize

public MemorySize(long bytes)

Constructs a new MemorySize.

Parameters:

bytes - The size, in bytes. Must be zero or larger.

Method Detail

getBytes

public long getBytes()

Gets the memory size in bytes.

getKibiBytes

public long getKibiBytes()

Gets the memory size in Kibibytes (= 1024 bytes).

getMebiBytes

public long getMebiBytes()

Gets the memory size in Mebibytes (= 1024 Kibibytes).

getGibiBytes

public long getGibiBytes()

Gets the memory size in Gibibytes (= 1024 Mebibytes).

getTebiBytes

public long getTebiBytes()

Gets the memory size in Tebibytes (= 1024 Gibibytes).

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

parse

public static MemorySize parse(String text)
                        throws IllegalArgumentException

Parses the given string as as MemorySize. The supported expressions are listed under MemorySize.

Parameters:

text - The string to parse

Returns:

The parsed MemorySize

Throws:

IllegalArgumentException - Thrown, if the expression cannot be parsed.

parseBytes

public static long parseBytes(String text)
                       throws IllegalArgumentException

Parses the given string as bytes. The supported expressions are listed under MemorySize.

Parameters:

text - The string to parse

Returns:

The parsed size, in bytes.

Throws:

IllegalArgumentException - Thrown, if the expression cannot be parsed.