What is a "UnityException" and is there any reason to use it over C#?

A quick search on UnityException doesn't reveal much.

I just noticed that there are "unity exceptions"

EG:

Code (csharp):

1.  
2.  
3.         if (thing.otherThing == null)
4.         {
5.             throw new UnityException("The other thing is null");
6.         }
7.  

(Where did I see this?? The adventure game tutorial codebase??)

I was just curious is someone has any thoughts on it.

The documentation is overwhelming in its volume of information:
https://docs.unity3d.com/455/Documentation/ScriptReference/UnityException.html

 

https://github.com/jameslinden/unit...81f/UnityEngine/UnityEngine/UnityException.cs

from the [RequiredByNativeCode] decoration I'm assuming it does more on the back end that I don't know about. Especially considering the unmodified by C# stack trace.

 

It inherits from Exception, so there's no harm using it, or not. Looks like a standard "may as well" thing: maybe you want to catch Unity errors specially, this lets you. Most functions that throw unity-specific errors probably throw it, since you always make your own exception classes.

That code snippet looks like typical "here's a simple example _showing_ it in use, which no one would ever do for real."

I'm guessing the docs are made by a tool. It lists unityException since it's there, not because it's something anyone needs to know about.

 

That documentation page is the best thing I've seen all year.

 

Thanks! I'm not up to the stage of dissecting the engine. I appreciate the look in.