Guava - Useful Classes

Guava - Collection Utilities

Guava - String Utilities

Guava - Primitive Utilities

Guava - Math Utilities

Guava - Useful Resources

Guava - Splitter Class

Quiz

Splitter provides various methods to handle splitting operations on string, objects, etc.

Class Declaration

Following is the declaration for com.google.common.base.Splitter class −

@GwtCompatible(emulated = true)
public final class Splitter
   extends Object

Sr.No	Method & Description
1	static Splitter fixedLength(int length) Returns a splitter that divides strings into pieces of the given length.
2	Splitter limit(int limit) Returns a splitter that behaves equivalently to this splitter but stops splitting after it reaches the limit.
3	Splitter omitEmptyStrings() Returns a splitter that behaves equivalently to this splitter, but automatically omits empty strings from the results.
4	static Splitter on(char separator) Returns a splitter that uses the given single-character separator.
5	static Splitter on(CharMatcher separatorMatcher) Returns a splitter that considers any single character matched by the given CharMatcher to be a separator.
6	static Splitter on(Pattern separatorPattern) Returns a splitter that considers any subsequence matching pattern to be a separator.
7	static Splitter on(String separator) Returns a splitter that uses the given fixed string as a separator.
8	static Splitter onPattern(String separatorPattern) Returns a splitter that considers any subsequence matching a given pattern (regular expression) to be a separator.
9	Iterable<String> split(CharSequence sequence) Splits sequence into string components and makes them available through an Iterator, which may be lazily evaluated.
10	List<String> splitToList(CharSequence sequence) Splits sequence into string components and returns them as an immutable list.
11	Splitter trimResults() Returns a splitter that behaves equivalently to this splitter, but automatically removes leading and trailing whitespace from each returned substring; equivalent to trimResults(CharMatcher.WHITESPACE).
12	Splitter trimResults(CharMatcher trimmer) Returns a splitter that behaves equivalently to this splitter, but removes all leading or trailing characters matching the given CharMatcher from each returned substring.
13	Splitter.MapSplitter withKeyValueSeparator(char separator) Returns a MapSplitter which splits entries based on this splitter, and splits entries into keys and values using the specified separator.
14	Splitter.MapSplitter withKeyValueSeparator(Splitter keyValueSplitter) Returns a MapSplitter which splits entries based on this splitter, and splits entries into keys and values using the specified key-value splitter.
15	Splitter.MapSplitter withKeyValueSeparator(String separator) Returns a MapSplitter which splits entries based on this splitter, and splits entries into keys and values using the specified separator.

Methods Inherited

This class inherits methods from the following class −

java.lang.Object

Example - Spliting a String based on Separator

GuavaTester.java

package com.tutorialspoint;

import com.google.common.base.Splitter;

public class GuavaTester {
   public static void main(String args[]) {
      GuavaTester tester = new GuavaTester();
      tester.testSplitter();
   }

   private void testSplitter() {
      Iterable<String> list = Splitter.on(',')
         .split("the ,quick, ,brown, fox, ,jumps, over, the, lazy, little, dog, ,,,,,.");
      System.out.println(list);
   }
}

Verify the Result

Run the GuavaTester and verify the output −

[the , quick,  , brown,  fox,  , jumps,  over,  the,  lazy,  little,  dog,  , , , , , .]

Example - Omit Empty String while Spliting Strings

GuavaTester.java

package com.tutorialspoint;

import com.google.common.base.Splitter;

public class GuavaTester {
   public static void main(String args[]) {
      GuavaTester tester = new GuavaTester();
      tester.testSplitter();
   }

   private void testSplitter() {
      Iterable<String> list = Splitter.on(',')
         .trimResults()
         .omitEmptyStrings()
         .split("the ,quick, ,brown, fox, ,jumps, over, the, lazy, little, dog, ,,,,,.");
      System.out.println(list);
   }
}

Verify the Result

Run the GuavaTester and verify the output −

[the, quick, brown, fox, jumps, over, the, lazy, little, dog, .]

Example - Spliting a String based on fixed length

GuavaTester.java

package com.tutorialspoint;

import com.google.common.base.Splitter;

public class GuavaTester {
   public static void main(String args[]) {
      GuavaTester tester = new GuavaTester();
      tester.testSplitter();
   }

   private void testSplitter() {
      Iterable<String> list = Splitter.fixedLength(5)
         .split("AbcdeEfghiGhijk");
      System.out.println(list);
   }
}

Verify the Result

Run the GuavaTester and verify the output −

[Abcde, Efghi, Ghijk]

Print Page