Coin (core 0.15 API)

java.lang.Object
- org.bitcoinj.core.Coin

All Implemented Interfaces:

java.io.Serializable, java.lang.Comparable<Coin>, Monetary
```
public final class Coin
extends java.lang.Object
implements Monetary, java.lang.Comparable<Coin>, java.io.Serializable
```
Represents a monetary Bitcoin value. This class is immutable.

See Also:

Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`static Coin`	`CENT` 0.01 Bitcoins.
`static Coin`	`COIN` One Bitcoin.
`static Coin`	`FIFTY_COINS`
`static Coin`	`MICROCOIN` 0.000001 Bitcoins, also known as 1 µBTC or 1 uBTC.
`static Coin`	`MILLICOIN` 0.001 Bitcoins, also known as 1 mBTC.
`static Coin`	`NEGATIVE_SATOSHI` Represents a monetary value of minus one satoshi.
`static Coin`	`SATOSHI` A satoshi is the smallest unit that can be transferred.
`static int`	`SMALLEST_UNIT_EXPONENT` Number of decimals for one Bitcoin.
`long`	`value` The number of satoshis of this monetary value.
`static Coin`	`ZERO` Zero Bitcoins.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Coin`	`add(Coin value)`
`int`	`compareTo(Coin other)`
`Coin`	`div(int divisor)` Alias for divide
`Coin`	`div(long divisor)` Alias for divide
`long`	`divide(Coin divisor)`
`Coin`	`divide(long divisor)`
`Coin[]`	`divideAndRemainder(long divisor)`
`boolean`	`equals(java.lang.Object o)`
`long`	`getValue()` Returns the number of satoshis of this monetary value.
`int`	`hashCode()`
`boolean`	`isGreaterThan(Coin other)` Returns true if the monetary value represented by this instance is greater than that of the given other Coin, otherwise false.
`boolean`	`isLessThan(Coin other)` Returns true if the monetary value represented by this instance is less than that of the given other Coin, otherwise false.
`boolean`	`isNegative()` Returns true if and only if this instance represents a monetary value less than zero, otherwise false.
`boolean`	`isPositive()` Returns true if and only if this instance represents a monetary value greater than zero, otherwise false.
`boolean`	`isZero()` Returns true if and only if this instance represents zero monetary value, otherwise false.
`long`	`longValue()` Returns the number of satoshis of this monetary value.
`Coin`	`minus(Coin value)` Alias for subtract
`Coin`	`multiply(long factor)`
`Coin`	`negate()`
`static Coin`	`parseCoin(java.lang.String str)` Parses an amount expressed in the way humans are used to.
`static Coin`	`parseCoinInexact(java.lang.String str)` Parses an amount expressed in the way humans are used to.
`Coin`	`plus(Coin value)` Alias for add
`Coin`	`shiftLeft(int n)`
`Coin`	`shiftRight(int n)`
`int`	`signum()`
`int`	`smallestUnitExponent()` Returns the absolute value of exponent of the value of a "smallest unit" in scientific notation.
`Coin`	`subtract(Coin value)`
`Coin`	`times(int factor)` Alias for multiply
`Coin`	`times(long factor)` Alias for multiply
`java.lang.String`	`toFriendlyString()` Returns the value as a 0.12 type string.
`java.lang.String`	`toPlainString()` Returns the value as a plain string denominated in BTC.
`java.lang.String`	`toString()`
`static Coin`	`valueOf(int coins, int cents)` Convert an amount expressed in the way humans are used to into satoshis.
`static Coin`	`valueOf(long satoshis)`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - SMALLEST_UNIT_EXPONENT
```
public static final int SMALLEST_UNIT_EXPONENT
```
    Number of decimals for one Bitcoin. This constant is useful for quick adapting to other coins because a lot of constants derive from it.
    
    See Also:
    
    Constant Field Values
  - ZERO
```
public static final Coin ZERO
```
    Zero Bitcoins.
  - COIN
```
public static final Coin COIN
```
    One Bitcoin.
  - CENT
```
public static final Coin CENT
```
    0.01 Bitcoins. This unit is not really used much.
  - MILLICOIN
```
public static final Coin MILLICOIN
```
    0.001 Bitcoins, also known as 1 mBTC.
  - MICROCOIN
```
public static final Coin MICROCOIN
```
    0.000001 Bitcoins, also known as 1 µBTC or 1 uBTC.
  - SATOSHI
```
public static final Coin SATOSHI
```
    A satoshi is the smallest unit that can be transferred. 100 million of them fit into a Bitcoin.
  - FIFTY_COINS
```
public static final Coin FIFTY_COINS
```
  - NEGATIVE_SATOSHI
```
public static final Coin NEGATIVE_SATOSHI
```
    Represents a monetary value of minus one satoshi.
  - value
```
public final long value
```
    The number of satoshis of this monetary value.
- Method Detail
  - valueOf
```
public static Coin valueOf(long satoshis)
```
  - smallestUnitExponent
```
public int smallestUnitExponent()
```
    Description copied from interface: Monetary
    
    Returns the absolute value of exponent of the value of a "smallest unit" in scientific notation. For Bitcoin, a satoshi is worth 1E-8 so this would be 8.
    
    Specified by:
    
    smallestUnitExponent in interface Monetary
  - getValue
```
public long getValue()
```
    Returns the number of satoshis of this monetary value.
    
    Specified by:
    
    getValue in interface Monetary
  - valueOf
```
public static Coin valueOf(int coins,
                           int cents)
```
    Convert an amount expressed in the way humans are used to into satoshis.
  - parseCoin
```
public static Coin parseCoin(java.lang.String str)
```
    Parses an amount expressed in the way humans are used to.
    
    This takes string in a format understood by BigDecimal.BigDecimal(String), for example "0", "1", "0.10", "1.23E3", "1234.5E-5".
    
    Throws:
    
    java.lang.IllegalArgumentException - if you try to specify fractional satoshis, or a value out of range.
  - parseCoinInexact
```
public static Coin parseCoinInexact(java.lang.String str)
```
    Parses an amount expressed in the way humans are used to. The amount is cut to satoshi precision.
    
    This takes string in a format understood by BigDecimal.BigDecimal(String), for example "0", "1", "0.10", "1.23E3", "1234.5E-5".
    
    Throws:
    
    java.lang.IllegalArgumentException - if you try to specify a value out of range.
  - add
```
public Coin add(Coin value)
```
  - plus
```
public Coin plus(Coin value)
```
    Alias for add
  - subtract
```
public Coin subtract(Coin value)
```
  - minus
```
public Coin minus(Coin value)
```
    Alias for subtract
  - multiply
```
public Coin multiply(long factor)
```
  - times
```
public Coin times(long factor)
```
    Alias for multiply
  - times
```
public Coin times(int factor)
```
    Alias for multiply
  - divide
```
public Coin divide(long divisor)
```
  - div
```
public Coin div(long divisor)
```
    Alias for divide
  - div
```
public Coin div(int divisor)
```
    Alias for divide
  - divideAndRemainder
```
public Coin[] divideAndRemainder(long divisor)
```
  - divide
```
public long divide(Coin divisor)
```
  - isPositive
```
public boolean isPositive()
```
    Returns true if and only if this instance represents a monetary value greater than zero, otherwise false.
  - isNegative
```
public boolean isNegative()
```
    Returns true if and only if this instance represents a monetary value less than zero, otherwise false.
  - isZero
```
public boolean isZero()
```
    Returns true if and only if this instance represents zero monetary value, otherwise false.
  - isGreaterThan
```
public boolean isGreaterThan(Coin other)
```
    Returns true if the monetary value represented by this instance is greater than that of the given other Coin, otherwise false.
  - isLessThan
```
public boolean isLessThan(Coin other)
```
    Returns true if the monetary value represented by this instance is less than that of the given other Coin, otherwise false.
  - shiftLeft
```
public Coin shiftLeft(int n)
```
  - shiftRight
```
public Coin shiftRight(int n)
```
  - signum
```
public int signum()
```
    Specified by:
    
    signum in interface Monetary
  - negate
```
public Coin negate()
```
  - longValue
```
public long longValue()
```
    Returns the number of satoshis of this monetary value. It's deprecated in favour of accessing value directly.
  - toFriendlyString
```
public java.lang.String toFriendlyString()
```
    Returns the value as a 0.12 type string. More digits after the decimal place will be used if necessary, but two will always be present.
  - toPlainString
```
public java.lang.String toPlainString()
```
    Returns the value as a plain string denominated in BTC. The result is unformatted with no trailing zeroes. For instance, a value of 150000 satoshis gives an output string of "0.0015" BTC
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - equals
```
public boolean equals(java.lang.Object o)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - compareTo
```
public int compareTo(Coin other)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<Coin>

Class Coin

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SMALLEST_UNIT_EXPONENT

ZERO

COIN

CENT

MILLICOIN

MICROCOIN

SATOSHI

FIFTY_COINS

NEGATIVE_SATOSHI

value

Method Detail

valueOf

smallestUnitExponent

getValue

valueOf

parseCoin

parseCoinInexact

add

plus

subtract

minus

multiply

times

times

divide

div

div

divideAndRemainder

divide

isPositive

isNegative

isZero

isGreaterThan

isLessThan

shiftLeft

shiftRight

signum

negate

longValue

toFriendlyString

toPlainString

toString

equals

hashCode

compareTo