Java HashMap putIfAbsent()

🎓 Top 15 Udemy Courses (80-90% Discount): My Udemy Courses - Ramesh Fadatare — All my Udemy courses are real-time and project oriented courses.

▶️ Subscribe to My YouTube Channel (178K+ subscribers): Java Guides on YouTube

▶️ For AI, ChatGPT, Web, Tech, and Generative AI, subscribe to another channel: Ramesh Fadatare on YouTube

In this guide, you will learn about the HashMap putIfAbsent() method in Java programming and how to use it with an example.

1. HashMap putIfAbsent() Method Overview

Definition:

The putIfAbsent() method of the HashMap class in Java is used to insert a specific key-value pair into the map only if the specified key is not already associated with a value (or the key is associated with null). If the map already contains the key, the existing value is retained and not replaced by the new value. The method returns the current (existing or computed) value associated with the key, or null if absent.

Syntax:

public V putIfAbsent(K key, V value)

Parameters:

- key: The key with which the specified value is to be associated.

- value: The value to be associated with the specified key.

Key Points:

- The putIfAbsent() method will insert the key-value pair only if the key is not already present in the map, or is associated with null.

- If the key is already present, the method will not modify the map and will return the current value associated with the key.

- If the key is not present, the method will add the key-value pair to the map and return null.

- The method allows storing null values and null keys in the HashMap.

2. HashMap putIfAbsent() Method Example

import java.util.HashMap;

public class HashMapPutIfAbsentExample {

    public static void main(String[] args) {
        HashMap<String, String> capitalMap = new HashMap<>();

        // Putting some key-value pairs in the HashMap
        capitalMap.put("USA", "Washington DC");
        capitalMap.put("Germany", "Berlin");

        // Printing the original HashMap
        System.out.println("Original HashMap: " + capitalMap);

        // Using putIfAbsent() - Key already exists
        String returnedValue1 = capitalMap.putIfAbsent("USA", "New York");
        System.out.println("Returned Value (USA): " + returnedValue1);

        // Using putIfAbsent() - Key does not exist
        String returnedValue2 = capitalMap.putIfAbsent("France", "Paris");
        System.out.println("Returned Value (France): " + returnedValue2);

        // Printing the updated HashMap
        System.out.println("Updated HashMap: " + capitalMap);
    }
}

Output:

Original HashMap: {USA=Washington DC, Germany=Berlin}
Returned Value (USA): Washington DC
Returned Value (France): null
Updated HashMap: {USA=Washington DC, Germany=Berlin, France=Paris}

Explanation:

In this example, we initially have a HashMap with some key-value pairs. 

We then use the putIfAbsent() method with a key that already exists in the map ("USA") and with a key that does not exist in the map ("France"). When the key already exists, the method returns the current value associated with the key and does not modify the map. When the key does not exist, the method inserts the new key-value pair and returns null. 

The output demonstrates the state of the HashMap before and after using the putIfAbsent() method, and the values returned by the method.

My Top and Bestseller Udemy Courses. The sale is going on with a 70 - 80% discount. The discount coupon has been added to each course below:

Build REST APIs with Spring Boot 4, Spring Security 7, and JWT

🆕 High-Demand 80–90% OFF

[NEW] Learn Apache Maven with IntelliJ IDEA and Java 25

🆕 High-Demand 80–90% OFF

ChatGPT + Generative AI + Prompt Engineering for Beginners

🚀 Trending Now 80–90% OFF

Spring 7 and Spring Boot 4 for Beginners (Includes 8 Projects)

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Real-Time REST APIs with Spring Boot - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Building Microservices with Spring Boot and Spring Cloud

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Java Full-Stack Developer Course with Spring Boot and React JS

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Build 5 Spring Boot Projects with Java: Line-by-Line Coding

🌟 Top Rated 80–90% OFF

Testing Spring Boot Application with JUnit and Mockito

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot Thymeleaf Real-Time Web Application - Blog App

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Master Spring Data JPA with Hibernate

🔥 Bestseller 80–90% OFF
Available in Udemy for Business

Spring Boot + Apache Kafka Course - The Practical Guide

🎓 Student Favorite 80–90% OFF
Available in Udemy for Business

Java Testing: Mastering JUnit 5 Framework

🆕 New 80–90% OFF

Reactive Programming in Java: Spring WebFlux and Testing

🌟 Top Rated 80–90% OFF

Spring Boot + RabbitMQ Course - The Practical Guide

🌟 Top Rated 80–90% OFF
Available in Udemy for Business

Functional Programming in Java (Includes Java Collections)

🎓 Student Favorite 80–90% OFF

ChatGPT for Java Developers: Boost Your Productivity with AI

🚀 Trending Now 80–90% OFF