Add Nullable Annotation To Some Library Methods (#1268)

RexJaeschke · web-flow · commit bebb8358d440 · 2025-02-06T09:09:43.000-05:00
* Add Nullable Annotation To Library Methods

* minor tweak
diff --git a/standard/standard-library.md b/standard/standard-library.md
@@ -32,15 +32,15 @@ namespace System
     public class ArgumentException : SystemException
     {
         public ArgumentException();
-        public ArgumentException(string message);
-        public ArgumentException(string message, Exception innerException);
+        public ArgumentException(string? message);
+        public ArgumentException(string? message, Exception? innerException);
     }
 
     public class ArithmeticException : Exception
     {
         public ArithmeticException();
-        public ArithmeticException(string message);
-        public ArithmeticException(string message, Exception innerException);
+        public ArithmeticException(string? message);
+        public ArithmeticException(string? message, Exception? innerException);
     }
 
     public abstract class Array : IList, ICollection, IEnumerable
@@ -53,9 +53,9 @@ namespace System
     public class ArrayTypeMismatchException : Exception
     {
         public ArrayTypeMismatchException();
-        public ArrayTypeMismatchException(string message);
-        public ArrayTypeMismatchException(string message,
-            Exception innerException);
+        public ArrayTypeMismatchException(string? message);
+        public ArrayTypeMismatchException(string? message,
+            Exception? innerException);
     }
 
     [AttributeUsageAttribute(AttributeTargets.All, Inherited = true,
@@ -103,8 +103,8 @@ namespace System
     public class DivideByZeroException : ArithmeticException
     {
         public DivideByZeroException();
-        public DivideByZeroException(string message);
-        public DivideByZeroException(string message, Exception innerException);
+        public DivideByZeroException(string? message);
+        public DivideByZeroException(string? message, Exception? innerException);
     }
 
     public readonly struct Double { }
@@ -117,9 +117,9 @@ namespace System
     public class Exception
     {
         public Exception();
-        public Exception(string message);
-        public Exception(string message, Exception innerException);
-        public sealed Exception InnerException { get; }
+        public Exception(string? message);
+        public Exception(string? message, Exception? innerException);
+        public sealed Exception? InnerException { get; }
         public virtual string Message { get; }
     }
 
@@ -135,9 +135,9 @@ namespace System
     public sealed class IndexOutOfRangeException : Exception
     {
         public IndexOutOfRangeException();
-        public IndexOutOfRangeException(string message);
-        public IndexOutOfRangeException(string message,
-            Exception innerException);
+        public IndexOutOfRangeException(string? message);
+        public IndexOutOfRangeException(string? message,
+            Exception? innerException);
     }
 
     public readonly struct Int16 { }
@@ -148,24 +148,24 @@ namespace System
     public class InvalidCastException : Exception
     {
         public InvalidCastException();
-        public InvalidCastException(string message);
-        public InvalidCastException(string message, Exception innerException);
+        public InvalidCastException(string? message);
+        public InvalidCastException(string? message, Exception? innerException);
     }
 
     public class InvalidOperationException : Exception
     {
         public InvalidOperationException();
-        public InvalidOperationException(string message);
-        public InvalidOperationException(string message,
-            Exception innerException);
+        public InvalidOperationException(string? message);
+        public InvalidOperationException(string? message,
+            Exception? innerException);
     }
 
     public class NotSupportedException : Exception
     {
         public NotSupportedException();
-        public NotSupportedException(string message);
-        public NotSupportedException(string message, 
-            Exception innerException);    
+        public NotSupportedException(string? message);
+        public NotSupportedException(string? message, 
+            Exception? innerException);    
     }
 
     public struct Nullable<T>
@@ -177,8 +177,8 @@ namespace System
     public class NullReferenceException : Exception
     {
         public NullReferenceException();
-        public NullReferenceException(string message);
-        public NullReferenceException(string message, Exception innerException);
+        public NullReferenceException(string? message);
+        public NullReferenceException(string? message, Exception? innerException);
     }
 
     public class Object
@@ -188,7 +188,7 @@ namespace System
         public virtual bool Equals(object obj);
         public virtual int GetHashCode();
         public Type GetType();
-        public virtual string ToString();
+        public virtual string? ToString();
     }
 
     [AttributeUsageAttribute(AttributeTargets.Class | AttributeTargets.Struct |
@@ -199,24 +199,24 @@ namespace System
     public sealed class ObsoleteAttribute : Attribute
     {
         public ObsoleteAttribute();
-        public ObsoleteAttribute(string message);
-        public ObsoleteAttribute(string message, bool error);
+        public ObsoleteAttribute(string? message);
+        public ObsoleteAttribute(string? message, bool error);
         public bool IsError { get; }
-        public string Message { get; }
+        public string Message? { get; }
     }
 
     public class OutOfMemoryException : Exception
     {
         public OutOfMemoryException();
-        public OutOfMemoryException(string message);
-        public OutOfMemoryException(string message, Exception innerException);
+        public OutOfMemoryException(string? message);
+        public OutOfMemoryException(string? message, Exception? innerException);
     }
 
     public class OverflowException : ArithmeticException
     {
         public OverflowException();
-        public OverflowException(string message);
-        public OverflowException(string message, Exception innerException);
+        public OverflowException(string? message);
+        public OverflowException(string? message, Exception? innerException);
     }
 
     public readonly struct SByte { }
@@ -225,15 +225,15 @@ namespace System
     public sealed class StackOverflowException : Exception
     {
         public StackOverflowException();
-        public StackOverflowException(string message);
-        public StackOverflowException(string message, Exception innerException);
+        public StackOverflowException(string? message);
+        public StackOverflowException(string? message, Exception? innerException);
     }
 
     public sealed class String : IEnumerable<Char>, IEnumerable
     {
         public int Length { get; }
         public char this [int index] { get; }
-        public static string Format(string format, params object[] args);
+        public static string Format(string format, params object?[] args);
     }
 
     public class SystemException : Exception
@@ -248,7 +248,7 @@ namespace System
     public sealed class TypeInitializationException : Exception
     {
         public TypeInitializationException(string fullTypeName,
-            Exception innerException);
+            Exception? innerException);
     }
 
     public readonly struct UInt16 { }
@@ -288,13 +288,13 @@ namespace System.Collections
     {
         bool IsFixedSize { get; }
         bool IsReadOnly { get; }
-        object this [int index] { get; set; }
-        int Add(object value);
+        object? this [int index] { get; set; }
+        int Add(object? value);
         void Clear();
-        bool Contains(object value);
-        int IndexOf(object value);
-        void Insert(int index, object value);
-        void Remove(object value);
+        bool Contains(object? value);
+        int IndexOf(object? value);
+        void Insert(int index, object? value);
+        void Remove(object? value);
         void RemoveAt(int index);
     }
 }
@@ -354,7 +354,7 @@ namespace System.Runtime.CompilerServices
 {
     public sealed class IndexerNameAttribute : Attribute
     {
-        public IndexerNameAttribute(String indexerName);
+        public IndexerNameAttribute(string indexerName);
     }
 
     public static class Unsafe
@@ -387,8 +387,8 @@ namespace System
     public class OperationCanceledException : Exception
     {
         public OperationCanceledException();
-        public OperationCanceledException(string message);
-        public OperationCanceledException(string message, Exception innerException);
+        public OperationCanceledException(string? message);
+        public OperationCanceledException(string? message, Exception? innerException);
     }
 
     public readonly ref struct ReadOnlySpan<T>
@@ -605,7 +605,7 @@ namespace System.Runtime.CompilerServices
     public static class FormattableStringFactory
     {
         public static FormattableString Create(string format,
-            params object[] arguments);
+            params object?[] arguments);
     }
 
     public interface ICriticalNotifyCompletion : INotifyCompletion

Original file line number	Diff line number	Diff line change
`@@ -32,15 +32,15 @@ namespace System`
`32`	`32`	`public class ArgumentException : SystemException`
`33`	`33`	`{`
`34`	`34`	`public ArgumentException();`
`35`		`- public ArgumentException(string message);`
`36`		`- public ArgumentException(string message, Exception innerException);`
	`35`	`+ public ArgumentException(string? message);`
	`36`	`+ public ArgumentException(string? message, Exception? innerException);`
`37`	`37`	`}`
`38`	`38`
`39`	`39`	`public class ArithmeticException : Exception`
`40`	`40`	`{`
`41`	`41`	`public ArithmeticException();`
`42`		`- public ArithmeticException(string message);`
`43`		`- public ArithmeticException(string message, Exception innerException);`
	`42`	`+ public ArithmeticException(string? message);`
	`43`	`+ public ArithmeticException(string? message, Exception? innerException);`
`44`	`44`	`}`
`45`	`45`
`46`	`46`	`public abstract class Array : IList, ICollection, IEnumerable`
`@@ -53,9 +53,9 @@ namespace System`
`53`	`53`	`public class ArrayTypeMismatchException : Exception`
`54`	`54`	`{`
`55`	`55`	`public ArrayTypeMismatchException();`
`56`		`- public ArrayTypeMismatchException(string message);`
`57`		`- public ArrayTypeMismatchException(string message,`
`58`		`- Exception innerException);`
	`56`	`+ public ArrayTypeMismatchException(string? message);`
	`57`	`+ public ArrayTypeMismatchException(string? message,`
	`58`	`+ Exception? innerException);`
`59`	`59`	`}`
`60`	`60`
`61`	`61`	`[AttributeUsageAttribute(AttributeTargets.All, Inherited = true,`
`@@ -103,8 +103,8 @@ namespace System`
`103`	`103`	`public class DivideByZeroException : ArithmeticException`
`104`	`104`	`{`
`105`	`105`	`public DivideByZeroException();`
`106`		`- public DivideByZeroException(string message);`
`107`		`- public DivideByZeroException(string message, Exception innerException);`
	`106`	`+ public DivideByZeroException(string? message);`
	`107`	`+ public DivideByZeroException(string? message, Exception? innerException);`
`108`	`108`	`}`
`109`	`109`
`110`	`110`	`public readonly struct Double { }`
`@@ -117,9 +117,9 @@ namespace System`
`117`	`117`	`public class Exception`
`118`	`118`	`{`
`119`	`119`	`public Exception();`
`120`		`- public Exception(string message);`
`121`		`- public Exception(string message, Exception innerException);`
`122`		`- public sealed Exception InnerException { get; }`
	`120`	`+ public Exception(string? message);`
	`121`	`+ public Exception(string? message, Exception? innerException);`
	`122`	`+ public sealed Exception? InnerException { get; }`
`123`	`123`	`public virtual string Message { get; }`
`124`	`124`	`}`
`125`	`125`
`@@ -135,9 +135,9 @@ namespace System`
`135`	`135`	`public sealed class IndexOutOfRangeException : Exception`
`136`	`136`	`{`
`137`	`137`	`public IndexOutOfRangeException();`
`138`		`- public IndexOutOfRangeException(string message);`
`139`		`- public IndexOutOfRangeException(string message,`
`140`		`- Exception innerException);`
	`138`	`+ public IndexOutOfRangeException(string? message);`
	`139`	`+ public IndexOutOfRangeException(string? message,`
	`140`	`+ Exception? innerException);`
`141`	`141`	`}`
`142`	`142`
`143`	`143`	`public readonly struct Int16 { }`
`@@ -148,24 +148,24 @@ namespace System`
`148`	`148`	`public class InvalidCastException : Exception`
`149`	`149`	`{`
`150`	`150`	`public InvalidCastException();`
`151`		`- public InvalidCastException(string message);`
`152`		`- public InvalidCastException(string message, Exception innerException);`
	`151`	`+ public InvalidCastException(string? message);`
	`152`	`+ public InvalidCastException(string? message, Exception? innerException);`
`153`	`153`	`}`
`154`	`154`
`155`	`155`	`public class InvalidOperationException : Exception`
`156`	`156`	`{`
`157`	`157`	`public InvalidOperationException();`
`158`		`- public InvalidOperationException(string message);`
`159`		`- public InvalidOperationException(string message,`
`160`		`- Exception innerException);`
	`158`	`+ public InvalidOperationException(string? message);`
	`159`	`+ public InvalidOperationException(string? message,`
	`160`	`+ Exception? innerException);`
`161`	`161`	`}`
`162`	`162`
`163`	`163`	`public class NotSupportedException : Exception`
`164`	`164`	`{`
`165`	`165`	`public NotSupportedException();`
`166`		`- public NotSupportedException(string message);`
`167`		`- public NotSupportedException(string message,`
`168`		`- Exception innerException);`
	`166`	`+ public NotSupportedException(string? message);`
	`167`	`+ public NotSupportedException(string? message,`
	`168`	`+ Exception? innerException);`
`169`	`169`	`}`
`170`	`170`
`171`	`171`	`public struct Nullable<T>`
`@@ -177,8 +177,8 @@ namespace System`
`177`	`177`	`public class NullReferenceException : Exception`
`178`	`178`	`{`
`179`	`179`	`public NullReferenceException();`
`180`		`- public NullReferenceException(string message);`
`181`		`- public NullReferenceException(string message, Exception innerException);`
	`180`	`+ public NullReferenceException(string? message);`
	`181`	`+ public NullReferenceException(string? message, Exception? innerException);`
`182`	`182`	`}`
`183`	`183`
`184`	`184`	`public class Object`
`@@ -188,7 +188,7 @@ namespace System`
`188`	`188`	`public virtual bool Equals(object obj);`
`189`	`189`	`public virtual int GetHashCode();`
`190`	`190`	`public Type GetType();`
`191`		`- public virtual string ToString();`
	`191`	`+ public virtual string? ToString();`
`192`	`192`	`}`
`193`	`193`
`194`	`194`	`[AttributeUsageAttribute(AttributeTargets.Class \| AttributeTargets.Struct \|`
`@@ -199,24 +199,24 @@ namespace System`
`199`	`199`	`public sealed class ObsoleteAttribute : Attribute`
`200`	`200`	`{`
`201`	`201`	`public ObsoleteAttribute();`
`202`		`- public ObsoleteAttribute(string message);`
`203`		`- public ObsoleteAttribute(string message, bool error);`
	`202`	`+ public ObsoleteAttribute(string? message);`
	`203`	`+ public ObsoleteAttribute(string? message, bool error);`
`204`	`204`	`public bool IsError { get; }`
`205`		`- public string Message { get; }`
	`205`	`+ public string Message? { get; }`
`206`	`206`	`}`
`207`	`207`
`208`	`208`	`public class OutOfMemoryException : Exception`
`209`	`209`	`{`
`210`	`210`	`public OutOfMemoryException();`
`211`		`- public OutOfMemoryException(string message);`
`212`		`- public OutOfMemoryException(string message, Exception innerException);`
	`211`	`+ public OutOfMemoryException(string? message);`
	`212`	`+ public OutOfMemoryException(string? message, Exception? innerException);`
`213`	`213`	`}`
`214`	`214`
`215`	`215`	`public class OverflowException : ArithmeticException`
`216`	`216`	`{`
`217`	`217`	`public OverflowException();`
`218`		`- public OverflowException(string message);`
`219`		`- public OverflowException(string message, Exception innerException);`
	`218`	`+ public OverflowException(string? message);`
	`219`	`+ public OverflowException(string? message, Exception? innerException);`
`220`	`220`	`}`
`221`	`221`
`222`	`222`	`public readonly struct SByte { }`
`@@ -225,15 +225,15 @@ namespace System`
`225`	`225`	`public sealed class StackOverflowException : Exception`
`226`	`226`	`{`
`227`	`227`	`public StackOverflowException();`
`228`		`- public StackOverflowException(string message);`
`229`		`- public StackOverflowException(string message, Exception innerException);`
	`228`	`+ public StackOverflowException(string? message);`
	`229`	`+ public StackOverflowException(string? message, Exception? innerException);`
`230`	`230`	`}`
`231`	`231`
`232`	`232`	`public sealed class String : IEnumerable<Char>, IEnumerable`
`233`	`233`	`{`
`234`	`234`	`public int Length { get; }`
`235`	`235`	`public char this [int index] { get; }`
`236`		`- public static string Format(string format, params object[] args);`
	`236`	`+ public static string Format(string format, params object?[] args);`
`237`	`237`	`}`
`238`	`238`
`239`	`239`	`public class SystemException : Exception`
`@@ -248,7 +248,7 @@ namespace System`
`248`	`248`	`public sealed class TypeInitializationException : Exception`
`249`	`249`	`{`
`250`	`250`	`public TypeInitializationException(string fullTypeName,`
`251`		`- Exception innerException);`
	`251`	`+ Exception? innerException);`
`252`	`252`	`}`
`253`	`253`
`254`	`254`	`public readonly struct UInt16 { }`
`@@ -288,13 +288,13 @@ namespace System.Collections`
`288`	`288`	`{`
`289`	`289`	`bool IsFixedSize { get; }`
`290`	`290`	`bool IsReadOnly { get; }`
`291`		`- object this [int index] { get; set; }`
`292`		`- int Add(object value);`
	`291`	`+ object? this [int index] { get; set; }`
	`292`	`+ int Add(object? value);`
`293`	`293`	`void Clear();`
`294`		`- bool Contains(object value);`
`295`		`- int IndexOf(object value);`
`296`		`- void Insert(int index, object value);`
`297`		`- void Remove(object value);`
	`294`	`+ bool Contains(object? value);`
	`295`	`+ int IndexOf(object? value);`
	`296`	`+ void Insert(int index, object? value);`
	`297`	`+ void Remove(object? value);`
`298`	`298`	`void RemoveAt(int index);`
`299`	`299`	`}`
`300`	`300`	`}`
`@@ -354,7 +354,7 @@ namespace System.Runtime.CompilerServices`
`354`	`354`	`{`
`355`	`355`	`public sealed class IndexerNameAttribute : Attribute`
`356`	`356`	`{`
`357`		`- public IndexerNameAttribute(String indexerName);`
	`357`	`+ public IndexerNameAttribute(string indexerName);`
`358`	`358`	`}`
`359`	`359`
`360`	`360`	`public static class Unsafe`
`@@ -387,8 +387,8 @@ namespace System`
`387`	`387`	`public class OperationCanceledException : Exception`
`388`	`388`	`{`
`389`	`389`	`public OperationCanceledException();`
`390`		`- public OperationCanceledException(string message);`
`391`		`- public OperationCanceledException(string message, Exception innerException);`
	`390`	`+ public OperationCanceledException(string? message);`
	`391`	`+ public OperationCanceledException(string? message, Exception? innerException);`
`392`	`392`	`}`
`393`	`393`
`394`	`394`	`public readonly ref struct ReadOnlySpan<T>`
`@@ -605,7 +605,7 @@ namespace System.Runtime.CompilerServices`
`605`	`605`	`public static class FormattableStringFactory`
`606`	`606`	`{`
`607`	`607`	`public static FormattableString Create(string format,`
`608`		`- params object[] arguments);`
	`608`	`+ params object?[] arguments);`
`609`	`609`	`}`
`610`	`610`
`611`	`611`	`public interface ICriticalNotifyCompletion : INotifyCompletion`