21.6

java.util.Properties

THE PACKAGE JAVA.UTIL

Properties from the defaults table of this

Properties

 table (if any) are

not

written out by this method.

If the header argument is not null, then an ASCII

#

 character, the header

string, and a newline are first written to the output stream. Thus, the

header

 can

serve as an identifying comment.

Next, a comment line is always written, consisting of an ASCII

#

 character,

the current date and time (as if produced by the

toString

 method of

Date

( 21.3.7) for the current time), and a newline.

Then every entry in this

Properties

 table is written out, one per line. For

each entry the key string is written, then an ASCII

=

, then the associated element

string. Each character of the element string is examined to see whether it should

be rendered as an escape sequence. The ASCII characters

\

, tab, newline, and car 

riage return are written as

\\

,

\t

,

\n

, and

\r

, respectively. Characters less than

\u0020

 and characters greater than

\u007E

 (if necessary, depending on the needs

of the localized output stream) are written as

\uxxxx

 for the appropriate hexadec 

imal value

xxxx

. Leading space characters, but not embedded or trailing space

characters, are written with a preceding

\

.

21.6.9

public void list(PrintStream out)

Properties (key and element pairs) in this

Properties

 table are written to the out 

put stream

out

 in a possibly abbreviated form that may be more convenient for

use in debugging than the output of the

save

 method. No header is written, and

element values longer than 40 character are truncated to the first 37 characters, to

which the characters  

...

  are appended. Thus, if the names of the keys are not

too long, there is a fighting chance that each property will fit into the space of one

line of a physical output device.

642