Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit fc60d843 authored by Jonathan Lepage's avatar Jonathan Lepage Committed by Automerger Merge Worker
Browse files

Merge "Document that Log can quietly swallow UnknownHostExceptions." am: 9d018456 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/1873073

Change-Id: Ie844b6702567a50388f4ff62e9bc28dbebdd4e81
parents 7a51a5f1 9d018456

core/java/android/util/Log.java

+7 −0
Original line number Diff line number Diff line
@@ -62,6 +62,10 @@ import java.net.UnknownHostException; 
 * another buffer allocation and copy, and even more pressure on the gc.

 * That means that if your log message is filtered out, you might be doing

 * significant work and incurring significant overhead.

 *

 * <p>When calling the log methods that take a Throwable parameter,

 * if any of the throwables in the cause chain is an <code>UnknownHostException</code>,

 * then the stack trace is not logged.

 */

public final class Log {

    /** @hide */
@@ -341,6 +345,9 @@ public final class Log { 


    /**

     * Handy function to get a loggable stack trace from a Throwable



     * <p>If any of the throwables in the cause chain is an <code>UnknownHostException</code>,

     * this returns an empty string.

     * @param tr An exception to log

     */

    @NonNull