String Contains() method in java with example - Internal Implementation


Java String contains() method. Learn contains() method in Java with example in java.lang.String package and its internal implementation. Learn about String class methods usage.

String contains() method in java with example:

The contains() method is Java method to check if String contains another substring or not. It returns boolean value so it can use directly inside if statements. This method returns true only if this string contains "s" else false. NullPointerException − if the value of s is null. This method is introduced in java 1.5 version.

String Contains() method


public boolean contains​(CharSequence s)


s - the sequence to search for

Return Value:

This method returns true only if and only this string contains "s" else false. 


NullPointerException − if the s value of s is null.

String contains() Example 1:

Example program to check the given string in present in the input string or not.

package examples.java.w3schools.string;

public class StringContainsExample {
 public static void main(String[] args) {

  String value1 = "Welcome to java-w3schools blog";
  String value2 = "w3schools";
  String value3 = "java";
  String value4 = "venkatesh";

  System.out.println("value1 : "+value1);
  System.out.println("value2 : "+value2);
  System.out.println("value3 : "+value3);

  // We will search now value2 is present in value1.
  System.out.println("Value1 contains value2 : " + value1.contains(value2));
  // We will search now value3 is present in value1.
  System.out.println("Value1 contains value3 : " + value1.contains(value3));
  // We will search now value4 is present in value1.
  System.out.println("Value1 contains value4 : " + value1.contains(value4));


value1 : Welcome to java-w3schools blog
value2 : w3schools
value3 : java
Value1 contains value2 : true
Value1 contains value3 : true
Value1 contains value4 : false

Here input string is "Welcome to java-w3schools blog" and checking "w3schools", "java" and "venkatesh" are present in input string. If it contains, returns ture. Otherwise, returns false.
First two contains statements print true. Last contains statement prints false because it is not in input string.

String contains() Example 2:

When to use contains() method? This method is really very helpful in the projects to check the specified string present in a particular strig. For example, we want to find the string if "Michael Jackson Became The King Of Pop" has "King" in it. This method is useful in such situation.

We will test with "King" and lowercase "king".

package examples.java.w3schools.string;

public class StringContainsExample2 {
 public static void main(String[] args) {

  String input = "Michael Jackson Became The King Of Pop";

  if (input.contains("King")) {
   System.out.println("Yes, Michael Jackson is The King Of Pop");
  } else {
   System.out.println("Noone will say Michael Jackson is not The King Of Pop");

String Contains() method-2


Yes, Michael Jackson is The King Of Pop

This example is based on if else condition.

String contains() NullPointerException example:

If we pass null to the contains method then will throw run-time exception saying NullPointerException.

package examples.java.w3schools.string;

public class StringContainsNullPointerEx {
 public static void main(String[] args) {

  String input = "Stars are visible during night.";



Exception in thread "main" java.lang.NullPointerException
 at java.base/java.lang.String.contains(String.java:2036)
 at w3schools/examples.java.w3schools.string.StringContainsNullPointerEx.main(StringContainsNullPointerEx.java:8)

String Contains() method Internal Implementation:

We will see now how Contains method is implemented internally or how Contains works internally.

Following is the contains method code in String class.

   public boolean contains(CharSequence s) {
        return indexOf(s.toString()) >= 0;

contains method internally calls indexof method.



About Us

Author: Venkatesh - I love to learn and share the technical stuff.

accumulo,1,ActiveMQ,2,Adsense,1,API,37,ArrayList,18,Arrays,24,Bean Creation,3,Bean Scopes,1,BiConsumer,1,Blogger Tips,1,Books,1,C Programming,1,Collection,8,Collections,37,Collector,1,Command Line,1,Comparator,1,Compile Errors,1,Configurations,7,Constants,1,Control Statements,8,Conversions,6,Core Java,149,Corona India,1,Create,2,CSS,1,Date,3,Date Time API,38,Dictionary,1,Difference,2,Download,1,Eclipse,3,Efficiently,1,Error,1,Errors,1,Exceptions,8,Fast,1,Files,17,Float,1,Font,1,Form,1,Freshers,1,Function,3,Functional Interface,2,Garbage Collector,1,Generics,4,Git,9,Grant,1,Grep,1,HashMap,2,HomeBrew,2,HTML,2,HttpClient,2,Immutable,1,Installation,1,Interview Questions,6,Iterate,2,Jackson API,3,Java,32,Java 10,1,Java 11,6,Java 12,5,Java 13,2,Java 14,2,Java 8,128,Java 8 Difference,2,Java 8 Stream Conversions,4,java 8 Stream Examples,12,Java 9,1,Java Conversions,14,Java Design Patterns,1,Java Files,1,Java Program,3,Java Programs,114,Java Spark,1,java.lang,4,java.util. function,1,JavaScript,1,jQuery,1,Kotlin,11,Kotlin Conversions,6,Kotlin Programs,10,Lambda,2,lang,29,Leap Year,1,live updates,1,LocalDate,1,Logging,1,Mac OS,3,Math,1,Matrix,6,Maven,1,Method References,1,Mockito,1,MongoDB,3,New Features,1,Operations,1,Optional,6,Oracle,5,Oracle 18C,1,Partition,1,Patterns,1,Programs,1,Property,1,Python,2,Quarkus,1,Read,1,Real Time,1,Recursion,2,Remove,2,Rest API,1,Schedules,1,Serialization,1,Servlet,2,Sort,1,Sorting Techniques,8,Spring,2,Spring Boot,23,Spring Email,1,Spring MVC,1,Streams,31,String,61,String Programs,28,String Revese,1,StringBuilder,1,Swing,1,System,1,Tags,1,Threads,11,Tomcat,1,Tomcat 8,1,Troubleshoot,26,Unix,3,Updates,3,util,5,While Loop,1,
JavaProgramTo.com: String Contains() method in java with example - Internal Implementation
String Contains() method in java with example - Internal Implementation
Java String contains() method. Learn contains() method in Java with example in java.lang.String package and its internal implementation. Learn about String class methods usage.
Loaded All Posts Not found any posts VIEW ALL Readmore Reply Cancel reply Delete By Home PAGES POSTS View All RECOMMENDED FOR YOU LABEL ARCHIVE SEARCH ALL POSTS Not found any post match with your request Back Home Sunday Monday Tuesday Wednesday Thursday Friday Saturday Sun Mon Tue Wed Thu Fri Sat January February March April May June July August September October November December Jan Feb Mar Apr May Jun Jul Aug Sep Oct Nov Dec just now 1 minute ago $$1$$ minutes ago 1 hour ago $$1$$ hours ago Yesterday $$1$$ days ago $$1$$ weeks ago more than 5 weeks ago Followers Follow THIS PREMIUM CONTENT IS LOCKED STEP 1: Share to a social network STEP 2: Click the link on your social network Copy All Code Select All Code All codes were copied to your clipboard Can not copy the codes / texts, please press [CTRL]+[C] (or CMD+C with Mac) to copy Table of Content