trim() removes newline char at the front?

[srinadh penugonda]

Hi java experts,
If I use trim() on a string that might contain newline char, will it be removed?
From the documentation, it says trim() removes leading and trailing whitespaces.
At the same time, I see this:
A character is a Java whitespace character if and only if it satisfies one of the following criteria:
It is a Unicode space character (SPACE_SEPARATOR, LINE_SEPARATOR, or PARAGRAPH_SEPARATOR) but is not also a non-breaking space ('\u00A0', '\u2007', '\u202F').
It is '\u0009', HORIZONTAL TABULATION.
It is '\u000A', LINE FEED.
It is '\u000B', VERTICAL TABULATION.
It is '\u000C', FORM FEED.
It is '\u000D', CARRIAGE RETURN.
It is '\u001C', FILE SEPARATOR.
It is '\u001D', GROUP SEPARATOR.
It is '\u001E', RECORD SEPARATOR.
It is '\u001F', UNIT SEPARATOR.

So, if I assume trim() removes any of the above characters, is my assumption right?

[Steve Luke]

Can you think of an easy way to test this, then report back to us to let us know the results?

[srinadh penugonda]

That is also my dilemma. How to test this? How to put newline char in a test string???

[Campbell Ritchie]

Originally posted by srinadh penugonda:
That is also my dilemma. How to test this? How to put newline char in a test string???

Sounds more like a beginner's question.

Look in the Java Tutorials.

[srinadh penugonda]

Thanks
You guys have really been of great help!!!
Much appreciated.
- a java beginner

[Peter Johnson]

There is no such thing as a newline character - newline is a concept that is implemented differently based on the OS:

In dos/windows it is 0x0D0A (CARRIAGE RETURN, LINE FEED)

In Linux/Unix it is 0x0A (LINE FEED)

On a Mac it is 0x0D (CARRIAGE RETURN) [or at least that is what I recall before OS/X, not sure if it is still the case]

Therefore, yes, trim() will remove newlines because it removes the characters used to represent newlines on the various OSes.

[Alan Moore]

The definition of whitespace characters you quoted comes from from the Character API docs; it has no bearing on the trim() method. The trim() doc tells exactly what it removes: characters whose ASCII value is less than or equal to 32 (or 0x20, the space character). That includes linefeeds and carriage returns.
[ August 21, 2008: Message edited by: Alan Moore ]

[Barclay Dunn]

Here is a sample test class that you might run to see how trim() works on some strings:

public class TrimTest {

    public static void main(String... args) throws Exception {

//        String testString = "\ntest-test-test";
//        String testString = "\rtest-test-test";
//        String testString = "test-test-test\n";
        String testString = "test-test-test\r";

        System.out.println("teststring:" + testString + ":endofteststring");

        String output = testString.trim();

        System.out.println("output:" + output + ":endofoutput");
    }
}

Uncomment the testString on which you want to see what the effect of trim() is, and run the code. If you use an IDE, you can probably run the code right in the IDE.