[ Web Proxy ]
URL:
Viewing: https://docs.unity3d.com/ScriptReference/EditorUserBuildSettings-explicitNullChecks.html [Back]  [Original]

Unity - Scripting API: EditorUserBuildSettings.explicitNullChecks
Version: Unity 6.5 (6000.5)
    • Supported
    • Legacy
    LanguageEnglish
    • C#

    EditorUserBuildSettings.explicitNullChecks

    Suggest a change

    Success!

    Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

    Close

    Submission failed

    For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

    Close
    Your name Your email Suggestion* Submit suggestion

    Cancel

    public static bool explicitNullChecks;

    Description

    When true, null references are actively validated in C++ generated by IL2CPP. When false, they are not.

    This setting is only supported for some closed platforms. On those platforms it's a configurable option in the platform build profile, and more information is available in the relevant platform-specific documentation.

    Important:

    • It's strongly recommended to keep null checks on. Turning them off can improve runtime performance, but doesn't prevent attempts to access null values, which can lead to unintended behavior including crashes. If you choose to turn null checks off, you must ensure that no null access occurs in the affected code.
    • On the platforms that support this setting, it applies globally to all C# code. It's recommended to use the [Il2CppSetOption] attribute instead, which is supported on all platfoms and allows you to apply the equivalent behavior more restrictively to specific methods, classes, or assemblies. For more information, refer to IL2CPP runtime code checks in the Unity manual.

    Web Proxy Viewer  |  New URL  |  Original Page