{"id":123486,"date":"2024-11-15T18:00:48","date_gmt":"2024-11-15T12:30:48","guid":{"rendered":"https:\/\/data-flair.training\/blogs\/?p=123486"},"modified":"2024-11-15T18:17:48","modified_gmt":"2024-11-15T12:47:48","slug":"java-string-contains-method","status":"publish","type":"post","link":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/","title":{"rendered":"Java String contains() Method"},"content":{"rendered":"<p>The contains() method in Java is a helpful string function that allows us to check if a particular String or character sequence occurs within another String. This method returns a boolean value indicating whether the sequence was found.<\/p>\n<p><strong>The essential signature of the contains() method is:<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">public boolean contains(CharSequence s)<\/pre>\n<p>It takes a single CharSequence parameter representing the sequence to search for. This can be another String or something like a StringBuilder. The method will return true if the sequence is found anywhere within the string and false otherwise.<\/p>\n<p>One thing to watch out for with contains() is the potential for a NullPointerException. This will occur if your call contains() on a null string reference. So, we need to carefully check for nulls before using this method.<\/p>\n<h2>How does the Java contain () Method Works Internally?<\/h2>\n<p>Behind the scenes, the contains() method converts the input CharSequence parameter to a String if necessary. This allows you to pass objects like StringBuilder safely without any issues.<\/p>\n<p>After this conversion, the method leverages the String class&#8217;s indexOf() method to determine if the sequence exists. More specifically, it checks if the return value from indexOf() is non-negative. A return value of 0 or greater indicates the index at which the sequence starts, meaning it was found.<\/p>\n<p>In summary, the contains() method is mostly just a simple wrapper around indexOf() that returns a boolean value instead of an index.<\/p>\n<h3>Examples of Using Java String contains()<\/h3>\n<p>Let&#8217;s look at some examples to see the contains() method used in actual code.<\/p>\n<h4>Basic Usage<\/h4>\n<p><strong>Here is a simple example that checks if a String contains another substring:<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">public class ContainsExample {\r\n    public static void main(String[] args) {\r\n        String str = \"Hello World\";\r\n        boolean contains = str.contains(\"World\");\r\n        System.out.println(contains); \/\/ Prints true\r\n    }\r\n}<\/pre>\n<p><strong>Output:<\/strong><br \/>\ntrue<\/p>\n<p>This demonstrates the primary usage &#8211; passing the sequence we want to find and getting a boolean result.<\/p>\n<h4>Case Sensitivity<\/h4>\n<p><strong>One crucial point about contains() is that it performs a case-sensitive search:<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">public class ContainsExample {\r\n    public static void main(String[] args) {\r\n        String str = \"Hello World\";\r\n        boolean contains = str.contains(\"world\");\r\n        System.out.println(contains); \/\/ Prints false\r\n    }\r\n}<\/pre>\n<p><strong>Output:<\/strong><br \/>\nFalse<br \/>\nSo the case must match exactly, or contains() will return false.<\/p>\n<h4>Using contains() in Control Structures.<\/h4>\n<p><strong>We can use the boolean result of contains() in control structures like if statements and loops:<\/strong><\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">public class ContainsExample {\r\n    public static void main(String[] args) {\r\n        String str = \"Hello World\";\r\n        if (str.contains(\"World\")) {\r\n            System.out.println(\"World found!\");\r\n        } else {\r\n            System.out.println(\"World not found!\");\r\n        }\r\n    }\r\n}<\/pre>\n<p><strong>Output:<\/strong><br \/>\nWorld found!<\/p>\n<p>This allows us to execute different logic depending on the result.<\/p>\n<h3>Limitations of contains() Method<\/h3>\n<p><strong>The contains() method is very convenient for basic substring searches but does have some limitations:<\/strong><\/p>\n<ul>\n<li>It is not well-suited for searching for individual characters. The indexOf() and lastIndexOf() methods are better for single char searches.<\/li>\n<li>It cannot tell us the index at which a sequence occurs &#8211; it only returns a boolean indicating if it was found. Again, indexOf() can provide the index.<\/li>\n<\/ul>\n<p>So, while contains() is great for a simple existence check, you may want to use indexOf() instead for more advanced scenarios. It provides more flexibility and information about where in the string the match occurred.<\/p>\n<h3>Conclusion<\/h3>\n<p>The Java String contains() method, a simple yet powerful way to check if a substring exists within another string. Returning a boolean value can be easily incorporated into control flow and logic. However, contains() is case-sensitive, can trigger NullPointerExceptions, and has limitations compared to indexOf().<\/p>\n<p>Overall, contains() provides an efficient mechanism for basic string search, but indexOf() may be required for more advanced use cases. With an awareness of its nuances, contains() can be leveraged to implement substring search logic in Java code cleanly.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The contains() method in Java is a helpful string function that allows us to check if a particular String or character sequence occurs within another String. This method returns a boolean value indicating whether&#46;&#46;&#46;<\/p>\n","protected":false},"author":86671,"featured_media":134225,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[32],"tags":[7345,31150,31153,31078,8152,31152,31151],"class_list":["post-123486","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-java","tag-java","tag-java-string-contains-method","tag-java-string-contains-method-with-examples","tag-java-tutorials","tag-learn-java","tag-string-contains-method","tag-string-contains-method-in-java"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.8 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Java String contains() Method - DataFlair<\/title>\n<meta name=\"description\" content=\"The Java String contains() method is a simple yet powerful way to check if a substring exists within another string.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Java String contains() Method - DataFlair\" \/>\n<meta property=\"og:description\" content=\"The Java String contains() method is a simple yet powerful way to check if a substring exists within another string.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/\" \/>\n<meta property=\"og:site_name\" content=\"DataFlair\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/DataFlairWS\/\" \/>\n<meta property=\"article:published_time\" content=\"2024-11-15T12:30:48+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2024-11-15T12:47:48+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"628\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"author\" content=\"TechVidvan Team\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@DataFlairWS\" \/>\n<meta name=\"twitter:site\" content=\"@DataFlairWS\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"TechVidvan Team\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"3 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Java String contains() Method - DataFlair","description":"The Java String contains() method is a simple yet powerful way to check if a substring exists within another string.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/","og_locale":"en_US","og_type":"article","og_title":"Java String contains() Method - DataFlair","og_description":"The Java String contains() method is a simple yet powerful way to check if a substring exists within another string.","og_url":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/","og_site_name":"DataFlair","article_publisher":"https:\/\/www.facebook.com\/DataFlairWS\/","article_published_time":"2024-11-15T12:30:48+00:00","article_modified_time":"2024-11-15T12:47:48+00:00","og_image":[{"width":1200,"height":628,"url":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp","type":"image\/webp"}],"author":"TechVidvan Team","twitter_card":"summary_large_image","twitter_creator":"@DataFlairWS","twitter_site":"@DataFlairWS","twitter_misc":{"Written by":"TechVidvan Team","Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#article","isPartOf":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/"},"author":{"name":"TechVidvan Team","@id":"https:\/\/data-flair.training\/blogs\/#\/schema\/person\/0e594f928e31fc96628ac40f6ae74f49"},"headline":"Java String contains() Method","datePublished":"2024-11-15T12:30:48+00:00","dateModified":"2024-11-15T12:47:48+00:00","mainEntityOfPage":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/"},"wordCount":538,"commentCount":0,"publisher":{"@id":"https:\/\/data-flair.training\/blogs\/#organization"},"image":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#primaryimage"},"thumbnailUrl":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp","keywords":["Java","java string contains() method","java string contains() method with examples","java tutorials","Learn Java","string contains() method","string contains() method in java"],"articleSection":["Java Tutorials"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/","url":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/","name":"Java String contains() Method - DataFlair","isPartOf":{"@id":"https:\/\/data-flair.training\/blogs\/#website"},"primaryImageOfPage":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#primaryimage"},"image":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#primaryimage"},"thumbnailUrl":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp","datePublished":"2024-11-15T12:30:48+00:00","dateModified":"2024-11-15T12:47:48+00:00","description":"The Java String contains() method is a simple yet powerful way to check if a substring exists within another string.","breadcrumb":{"@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/data-flair.training\/blogs\/java-string-contains-method\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#primaryimage","url":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp","contentUrl":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2023\/11\/string-contains.webp","width":1200,"height":628,"caption":"string contains()"},{"@type":"BreadcrumbList","@id":"https:\/\/data-flair.training\/blogs\/java-string-contains-method\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Blog Home","item":"https:\/\/data-flair.training\/blogs\/"},{"@type":"ListItem","position":2,"name":"Java Tutorials","item":"https:\/\/data-flair.training\/blogs\/category\/java\/"},{"@type":"ListItem","position":3,"name":"Java String contains() Method"}]},{"@type":"WebSite","@id":"https:\/\/data-flair.training\/blogs\/#website","url":"https:\/\/data-flair.training\/blogs\/","name":"DataFlair","description":"Learn Today. Lead Tomorrow.","publisher":{"@id":"https:\/\/data-flair.training\/blogs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/data-flair.training\/blogs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/data-flair.training\/blogs\/#organization","name":"DataFlair","url":"https:\/\/data-flair.training\/blogs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/data-flair.training\/blogs\/#\/schema\/logo\/image\/","url":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2016\/07\/Data-Flair.png","contentUrl":"https:\/\/data-flair.training\/blogs\/wp-content\/uploads\/sites\/2\/2016\/07\/Data-Flair.png","width":106,"height":48,"caption":"DataFlair"},"image":{"@id":"https:\/\/data-flair.training\/blogs\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/DataFlairWS\/","https:\/\/x.com\/DataFlairWS","https:\/\/www.linkedin.com\/company\/dataflair-web-services-pvt-ltd\/","https:\/\/www.youtube.com\/user\/DataFlairWS"]},{"@type":"Person","@id":"https:\/\/data-flair.training\/blogs\/#\/schema\/person\/0e594f928e31fc96628ac40f6ae74f49","name":"TechVidvan Team","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/c89190da3d4010c71ba476b618ab10fdc2335c82cdfa0ad5002d98d0f2473444?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/c89190da3d4010c71ba476b618ab10fdc2335c82cdfa0ad5002d98d0f2473444?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/c89190da3d4010c71ba476b618ab10fdc2335c82cdfa0ad5002d98d0f2473444?s=96&d=mm&r=g","caption":"TechVidvan Team"},"description":"TechVidvan Team provides high-quality content &amp; courses on AI, ML, Data Science, Data Engineering, Data Analytics, programming, Python, DSA, Android, Flutter, full stack web dev, MERN, and many latest technology.","url":"https:\/\/data-flair.training\/blogs\/author\/test001\/"}]}},"amp_enabled":true,"_links":{"self":[{"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/posts\/123486","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/users\/86671"}],"replies":[{"embeddable":true,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/comments?post=123486"}],"version-history":[{"count":6,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/posts\/123486\/revisions"}],"predecessor-version":[{"id":143618,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/posts\/123486\/revisions\/143618"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/media\/134225"}],"wp:attachment":[{"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/media?parent=123486"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/categories?post=123486"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/data-flair.training\/blogs\/wp-json\/wp\/v2\/tags?post=123486"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}