THE PACKAGE JAVA.LANG

java.lang.Long

20.8

20.8.21

public static Long getLong(String nm)

The first argument is treated as the name of a system property to be obtained as if

by the method

System.getProperty

 ( 20.18.9). The string value of this prop 

erty is then interpreted as an integer value and a

Long

 object representing this

value is returned. If there is no property of the specified name, or if the property

does not have the correct numeric format, then

null

 is returned.

In other words, this method returns a

Long

 object equal to the value of:

getLong(nm, null)

20.8.22

public static Long getLong(String nm, long val)

The first argument is treated as the name of a system property to be obtained as if

by the method

System.getProperty

 ( 20.18.9). The string value of this prop 

erty is then interpreted as an integer value and a

Long

 object representing this

value is returned. If there is no property of the specified name, or if the property

does not have the correct numeric format, then a

Long

 object that represents the

value of the second argument is returned.

In other words, this method returns a

Long

 object equal to the value of:

getLong(nm, new Long(val))

but in practice it may be implemented in a manner such as:

Long result = getLong(nm, null);

return (result == null) ? new Long(val) : result;

to avoid the unnecessary allocation of a

Long

 object when the default value is not

needed.

20.8.23

public static Long getLong(String nm, Long val)

The first argument is treated as the name of a system property to be obtained as if

by the method

System.getProperty

 ( 20.18.9). The string value of this prop 

erty is then interpreted as an integer value and a

Long

 object representing this

value is returned.

If the property value begins with the two ASCII characters

0x

 or the ASCII

character

#

, not followed by a minus sign, then the rest of it is parsed as a

hexadecimal integer exactly as for the method

Long.valueOf

 ( 20.7.20) with

radix

16

.

501