jvmMain.kotlin.jvm.internal.Intrinsics Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of kotlin-stdlib Show documentation
Show all versions of kotlin-stdlib Show documentation
Kotlin Standard Library for JVM
/*
* Copyright 2010-2018 JetBrains s.r.o. and Kotlin Programming Language contributors.
* Use of this source code is governed by the Apache 2.0 license that can be found in the license/LICENSE.txt file.
*/
package kotlin.jvm.internal;
import kotlin.KotlinNullPointerException;
import kotlin.SinceKotlin;
import kotlin.UninitializedPropertyAccessException;
import java.util.Arrays;
@SuppressWarnings({"unused", "WeakerAccess"})
public class Intrinsics {
private Intrinsics() {
}
public static String stringPlus(String self, Object other) {
return self + other;
}
public static void checkNotNull(Object object) {
if (object == null) {
throwJavaNpe();
}
}
public static void checkNotNull(Object object, String message) {
if (object == null) {
throwJavaNpe(message);
}
}
public static void throwNpe() {
throw sanitizeStackTrace(new KotlinNullPointerException());
}
public static void throwNpe(String message) {
throw sanitizeStackTrace(new KotlinNullPointerException(message));
}
@SinceKotlin(version = "1.4")
public static void throwJavaNpe() {
throw sanitizeStackTrace(new NullPointerException());
}
@SinceKotlin(version = "1.4")
public static void throwJavaNpe(String message) {
throw sanitizeStackTrace(new NullPointerException(message));
}
public static void throwUninitializedProperty(String message) {
throw sanitizeStackTrace(new UninitializedPropertyAccessException(message));
}
public static void throwUninitializedPropertyAccessException(String propertyName) {
throwUninitializedProperty("lateinit property " + propertyName + " has not been initialized");
}
public static void throwAssert() {
throw sanitizeStackTrace(new AssertionError());
}
public static void throwAssert(String message) {
throw sanitizeStackTrace(new AssertionError(message));
}
public static void throwIllegalArgument() {
throw sanitizeStackTrace(new IllegalArgumentException());
}
public static void throwIllegalArgument(String message) {
throw sanitizeStackTrace(new IllegalArgumentException(message));
}
public static void throwIllegalState() {
throw sanitizeStackTrace(new IllegalStateException());
}
public static void throwIllegalState(String message) {
throw sanitizeStackTrace(new IllegalStateException(message));
}
public static void checkExpressionValueIsNotNull(Object value, String expression) {
if (value == null) {
throw sanitizeStackTrace(new IllegalStateException(expression + " must not be null"));
}
}
public static void checkNotNullExpressionValue(Object value, String expression) {
if (value == null) {
throw sanitizeStackTrace(new NullPointerException(expression + " must not be null"));
}
}
public static void checkReturnedValueIsNotNull(Object value, String className, String methodName) {
if (value == null) {
throw sanitizeStackTrace(
new IllegalStateException("Method specified as non-null returned null: " + className + "." + methodName)
);
}
}
public static void checkReturnedValueIsNotNull(Object value, String message) {
if (value == null) {
throw sanitizeStackTrace(new IllegalStateException(message));
}
}
public static void checkFieldIsNotNull(Object value, String className, String fieldName) {
if (value == null) {
throw sanitizeStackTrace(new IllegalStateException("Field specified as non-null is null: " + className + "." + fieldName));
}
}
public static void checkFieldIsNotNull(Object value, String message) {
if (value == null) {
throw sanitizeStackTrace(new IllegalStateException(message));
}
}
public static void checkParameterIsNotNull(Object value, String paramName) {
if (value == null) {
throwParameterIsNullIAE(paramName);
}
}
public static void checkNotNullParameter(Object value, String paramName) {
if (value == null) {
throwParameterIsNullNPE(paramName);
}
}
private static void throwParameterIsNullIAE(String paramName) {
throw sanitizeStackTrace(new IllegalArgumentException(createParameterIsNullExceptionMessage(paramName)));
}
private static void throwParameterIsNullNPE(String paramName) {
throw sanitizeStackTrace(new NullPointerException(createParameterIsNullExceptionMessage(paramName)));
}
private static String createParameterIsNullExceptionMessage(String paramName) {
StackTraceElement[] stackTraceElements = Thread.currentThread().getStackTrace();
String thisClassName = Intrinsics.class.getName();
int i = 0;
// Skip platform frames such as Thread.getStackTrace.
while (!stackTraceElements[i].getClassName().equals(thisClassName)) i++;
// Skip all frames of this class such as createParameterIsNullExceptionMessage, throwParameterIsNullNPE, checkNotNullParameter.
while (stackTraceElements[i].getClassName().equals(thisClassName)) i++;
// This frame is our caller.
StackTraceElement caller = stackTraceElements[i];
String className = caller.getClassName();
String methodName = caller.getMethodName();
return "Parameter specified as non-null is null: method " + className + "." + methodName + ", parameter " + paramName;
}
public static int compare(long thisVal, long anotherVal) {
return thisVal < anotherVal ? -1 : thisVal == anotherVal ? 0 : 1;
}
public static int compare(int thisVal, int anotherVal) {
return thisVal < anotherVal ? -1 : thisVal == anotherVal ? 0 : 1;
}
public static boolean areEqual(Object first, Object second) {
return first == null ? second == null : first.equals(second);
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(Double first, Double second) {
return first == null ? second == null : second != null && first.doubleValue() == second.doubleValue();
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(Double first, double second) {
return first != null && first.doubleValue() == second;
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(double first, Double second) {
return second != null && first == second.doubleValue();
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(Float first, Float second) {
return first == null ? second == null : second != null && first.floatValue() == second.floatValue();
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(Float first, float second) {
return first != null && first.floatValue() == second;
}
@SinceKotlin(version = "1.1")
public static boolean areEqual(float first, Float second) {
return second != null && first == second.floatValue();
}
public static void throwUndefinedForReified() {
throwUndefinedForReified(
"This function has a reified type parameter and thus can only be inlined at compilation time, not called directly."
);
}
public static void throwUndefinedForReified(String message) {
throw new UnsupportedOperationException(message);
}
public static void reifiedOperationMarker(int id, String typeParameterIdentifier) {
throwUndefinedForReified();
}
public static void reifiedOperationMarker(int id, String typeParameterIdentifier, String message) {
throwUndefinedForReified(message);
}
public static void needClassReification() {
throwUndefinedForReified();
}
public static void needClassReification(String message) {
throwUndefinedForReified(message);
}
public static void checkHasClass(String internalName) throws ClassNotFoundException {
String fqName = internalName.replace('/', '.');
try {
Class.forName(fqName);
}
catch (ClassNotFoundException e) {
throw sanitizeStackTrace(new ClassNotFoundException(
"Class " + fqName + " is not found. Please update the Kotlin runtime to the latest version", e
));
}
}
public static void checkHasClass(String internalName, String requiredVersion) throws ClassNotFoundException {
String fqName = internalName.replace('/', '.');
try {
Class.forName(fqName);
}
catch (ClassNotFoundException e) {
throw sanitizeStackTrace(new ClassNotFoundException(
"Class " + fqName + " is not found: this code requires the Kotlin runtime of version at least " + requiredVersion, e
));
}
}
private static T sanitizeStackTrace(T throwable) {
return sanitizeStackTrace(throwable, Intrinsics.class.getName());
}
static T sanitizeStackTrace(T throwable, String classNameToDrop) {
StackTraceElement[] stackTrace = throwable.getStackTrace();
int size = stackTrace.length;
int lastIntrinsic = -1;
for (int i = 0; i < size; i++) {
if (classNameToDrop.equals(stackTrace[i].getClassName())) {
lastIntrinsic = i;
}
}
StackTraceElement[] newStackTrace = Arrays.copyOfRange(stackTrace, lastIntrinsic + 1, size);
throwable.setStackTrace(newStackTrace);
return throwable;
}
// Stub class which is used as an owner of callable references for built-ins declared in package "kotlin".
@SinceKotlin(version = "1.4")
public static class Kotlin {
private Kotlin() {
}
}
}