Examples of org.jostraca.comp.gnu.regexp.REMatchEnumeration

org.jostraca.comp.gnu.regexp.REMatchEnumeration

An REMatchEnumeration enumerates regular expression matches over a given input text. You obtain a reference to an enumeration using the getMatchEnumeration() methods on an instance of RE.

REMatchEnumeration does lazy computation; that is, it will not search for a match until it needs to. If you'd rather just get all the matches at once in a big array, use the getAllMatches() methods on RE. However, using an enumeration can help speed performance when the entire text does not need to be searched immediately.

The enumerated type is especially useful when searching on a Reader or InputStream, because the InputStream read position cannot be guaranteed after calling getMatch() (see the description of that method for an explanation of why). Enumeration also saves a lot of overhead required when calling getMatch() multiple times. @author Wes Biggs

  }




  public RegExpMatch[] matchAll( String pSource ) throws RegExpException {
    String             source = (String) Internal.null_arg( pSource );
    REMatchEnumeration me     = iRegExp.getMatchEnumeration( source );
    if( null == me ) {
      return new RegExpMatch[] {};
    }
    else {
      Vector mV = new Vector();
      while( me.hasMoreElements() ) {
        REMatch m = (REMatch) me.nextElement();
        mV.addElement( new GnuRegExpMatch( m ) );
      }
      RegExpMatch[] rem = new RegExpMatch[ mV.size() ];
      mV.copyInto( rem );
      return rem;

Examples of org.jostraca.comp.gnu.regexp.REMatchEnumeration

Related Classes of org.jostraca.comp.gnu.regexp.REMatchEnumeration