From 5f3b1ccf9012f03cfa5360de43408cb13fe0936c Mon Sep 17 00:00:00 2001
From: agnostic-apollo <agnosticapollo@gmail.com>
Date: Sat, 11 Sep 2021 13:50:11 +0500
Subject: [PATCH] Added: Add getDefaultIfUnset() to DataUtils and update
 comment

---
 .../main/java/com/termux/shared/data/DataUtils.java | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/termux-shared/src/main/java/com/termux/shared/data/DataUtils.java b/termux-shared/src/main/java/com/termux/shared/data/DataUtils.java
index 7c101c73..50f0e7ba 100644
--- a/termux-shared/src/main/java/com/termux/shared/data/DataUtils.java
+++ b/termux-shared/src/main/java/com/termux/shared/data/DataUtils.java
@@ -10,6 +10,8 @@ import java.io.Serializable;
 
 public class DataUtils {
 
+    /** Max safe limit of data size to prevent TransactionTooLargeException when transferring data
+     * inside or to other apps via transactions. */
     public static final int TRANSACTION_SIZE_LIMIT_IN_BYTES = 100 * 1024; // 100KB
 
     private static final char[] HEX_ARRAY = "0123456789ABCDEF".toCharArray();
@@ -171,6 +173,17 @@ public class DataUtils {
         return (object == null) ? def : object;
     }
 
+    /**
+     * Get the {@link String} itself if it is not {@code null} or empty, otherwise default.
+     *
+     * @param value The {@link String} to check.
+     * @param def The default {@link String}.
+     * @return Returns {@code value} if it is not {@code null} or empty, otherwise returns {@code def}.
+     */
+    public static String getDefaultIfUnset(@Nullable String value, String def) {
+        return (value == null || value.isEmpty()) ? def : value;
+    }
+
     /** Check if a string is null or empty. */
     public static boolean isNullOrEmpty(String string) {
         return string == null || string.isEmpty();