Package 

Class PhoneNumberMatch

  • 
public final class PhoneNumberMatch

    The immutable match of a phone number within a piece of text. Matches may be found using findNumbers.

    A match consists of the phone number as well as the start and end offsets of the corresponding subsequence of the searched text. Use rawString to obtain a copy of the matched subsequence.

    The following annotated example clarifies the relationship between the searched text, the match offsets, and the parsed number:

    CharSequence text = "Call me at +1 425 882-8080 for details.";
String country = "US";
PhoneNumberUtil util = PhoneNumberUtil.getInstance();

// Find the first phone number match:
PhoneNumberMatch m = util.findNumbers(text, country).iterator().next();

// rawString() contains the phone number as it appears in the text.
"+1 425 882-8080".equals(m.rawString());

// start() and end() define the range of the matched subsequence.
CharSequence subsequence = text.subSequence(m.start(), m.end());
"+1 425 882-8080".contentEquals(subsequence);

// number() returns the the same result as PhoneNumberUtil.parse()
// invoked on rawString().
util.parse(m.rawString(), country).equals(m.number());

    • Method Summary

      Modifier and Type Method Description
      Phonenumber.PhoneNumber number() Returns the phone number matched by the receiver.
      int start() Returns the start index of the matched phone number within the searched text.
      int end() Returns the exclusive end index of the matched phone number within the searched text.
      String rawString() Returns the raw string matched as a phone number in the searched text.
      int hashCode()
      boolean equals(Object obj)
      String toString()

      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    • Method Detail

      • start

         int start()

        Returns the start index of the matched phone number within the searched text.

      • end

         int end()

        Returns the exclusive end index of the matched phone number within the searched text.

      • rawString

         String rawString()

        Returns the raw string matched as a phone number in the searched text.