Java Scanner findWithinHorizon() Method

The findWithinHorizon() is a Java Scanner class method which is used to find the next occurance of a pattern. There is two different types of Java findWithinHorizon() method which can be differentiated depending on its parameter. These are:

Java Scanner findWithinHorizon(Pattern pattern, int horizon) Method
Java Scanner findWithinHorizon(String pattern, int horizon) Method

findWithinHorizon(Pattern pattern, int horizon) Method

This is an inbuilt method of Java Scanner class which is used to find the next occurrence of the specified pattern. This method searches through the input up to the specified search horizon, ignoring delimiters.

findWithinHorizon(String pattern, int horizon) Method

This is a Java Scanner class method which is used to find the next occurrence of a pattern constructed from the specified string, ignoring delimiters.

Syntax

Following is the declaration of findWithinHorizon() method:

public String findWithinHorizon(String pattern, int horizon)
public String findWithinHorizon(Pattern pattern, int horizon)

Parameter

DataType	Parameter	Description	Required/Optional
int	horizon	It is the search horizon	Required
String	pattern	It is a string specifying the pattern to search for	Required
Pattern	pattern	It is the pattern to scan for	Required

Returns

The findWithinHorizon() method returns the text that matched the specified pattern.

Exceptions

IllegalStateException- This method throws exception if the innvocation is done after the scanner has been closed.

IllegalArgumentException- It thrown this exception if horizon is negative.

Compatibility Version

Java 1.5 and above

Example 1

import java.util.Scanner;
import java.util.regex.Pattern;  
public class ScannerFindWithinHorizonExample1 {  
   public static void main(String args[]){	   
	   String string = "Hello JavaTpoint! --> 1111, 2222, 3333";
	   Pattern pattern = Pattern.compile("[0-9]+");
	   Scanner scanner = new Scanner(string);
	   while (scanner.hasNext()) {
	         System.out.println("Output = " + scanner.findWithinHorizon(pattern, 26));
	   }
	   scanner.close();
   	   }  
}

Output:

Output = 1111
Output = 2222
Output = 3333

Example 2

import java.util.*;
public class ScannerFindWithinHorizonExample2 {  
	public static void main(String[] args) {
		//Initialize scanner object
		Scanner scan = new Scanner("x12 13 16 210");
		//Declare horizon
		int horizon = 8;
		//Print the result
		System.out.println("Print the string that satisifies the pattern within the horizon-");
		System.out.println("Result: "+scan.findWithinHorizon("[0-9].*", horizon));
		scan.close();
		}
}

Output:

Print the string that satisifies the pattern within the horizon-
Result: 12 13 1

Example 3

import java.util.Scanner;  
public class ScannerFindWithinHorizonExample3{  
   public static void main(String args[]){ 
	   String str = "Hello World! This is javaTpoint.";
	   //Create a new scanner Object
	   Scanner scanner = new Scanner(str);	      	      
	   //Print the result
         System.out.println("Output: " + scanner.findWithinHorizon("[a-zA-Z].*", -16));
	   //Print the rest of the string
	   System.out.println("Left String: " + scanner.nextLine());
	   scanner.close();
         }  
}

Output:

Exception in thread "main" java.lang.IllegalArgumentException: horizon < 0
	at java.base/java.util.Scanner.findWithinHorizon(Scanner.java:1785)
	at java.base/java.util.Scanner.findWithinHorizon(Scanner.java:1746)
	at myPackage.ScannerFindWithinHorizonExample3.main(ScannerFindWithinHorizonExample3.java:9)

Example 4

import java.util.*;
import java.util.regex.Pattern;  
public class ScannerFindWithinHorizonExample4{  
   public static void main(String args[]){ 
	   Scanner scan = new Scanner(System.in);
	   String userName;  
	   System.out.print("Enter your email address: ");
	   userName = scan.findWithinHorizon(Pattern.compile("[a-z]+"), 16);
	   System.out.println("Output:"+userName);
	   scan.close();
         }  
}

Output:

Enter your email address: [email protected]
Output:abhishek

Next TopicJava Scanner Class

← prev next →

Help Others, Please Share

Javatpoint Services

JavaTpoint offers too many high quality services. Mail us on [email protected], to get more information about given services.

Website Designing
Website Development
Java Development
PHP Development
WordPress
Graphic Designing
Logo
Digital Marketing
On Page and Off Page SEO
PPC
Content Development
Corporate Training
Classroom and Online Training
Data Entry

Training For College Campus

JavaTpoint offers college campus training on Core Java, Advance Java, .Net, Android, Hadoop, PHP, Web Technology and Python. Please mail your requirement at [email protected].
Duration: 1 week to 2 week

^{Like/Subscribe us for latest updates or newsletter}