Adding string cast operators and null APIs to Variant

sdk/core/Azure.Core.Experimental/api/Azure.Core.Experimental.net461.cs

@@ -19,6 +19,7 @@ public readonly partial struct Variant
     {
         private readonly object _dummy;
         private readonly int _dummyPrimitive;
+        public static readonly Azure.Variant Null;
         public Variant(System.ArraySegment<byte> segment) { throw null; }
         public Variant(System.ArraySegment<char> segment) { throw null; }
         public Variant(bool value) { throw null; }
@@ -50,6 +51,7 @@ public readonly partial struct Variant
         public Variant(ushort value) { throw null; }
         public Variant(uint value) { throw null; }
         public Variant(ulong value) { throw null; }
+        public bool IsNull { get { throw null; } }
         public System.Type? Type { get { throw null; } }
         [System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.AggressiveInlining)]public T As<T>() { throw null; }
         public static Azure.Variant Create<T>(T value) { throw null; }
@@ -82,6 +84,7 @@ public readonly partial struct Variant
         public static explicit operator ulong? (in Azure.Variant value) { throw null; }
         public static explicit operator sbyte (in Azure.Variant value) { throw null; }
         public static explicit operator float (in Azure.Variant value) { throw null; }
+        public static explicit operator string (in Azure.Variant value) { throw null; }
         public static explicit operator ushort (in Azure.Variant value) { throw null; }
         public static explicit operator uint (in Azure.Variant value) { throw null; }
         public static explicit operator ulong (in Azure.Variant value) { throw null; }
@@ -114,6 +117,7 @@ public readonly partial struct Variant
         public static implicit operator Azure.Variant (ulong? value) { throw null; }
         public static implicit operator Azure.Variant (sbyte value) { throw null; }
         public static implicit operator Azure.Variant (float value) { throw null; }
+        public static implicit operator Azure.Variant (string value) { throw null; }
         public static implicit operator Azure.Variant (ushort value) { throw null; }
         public static implicit operator Azure.Variant (uint value) { throw null; }
         public static implicit operator Azure.Variant (ulong value) { throw null; }

sdk/core/Azure.Core.Experimental/api/Azure.Core.Experimental.net6.0.cs

@@ -19,6 +19,7 @@ public readonly partial struct Variant
     {
         private readonly object _dummy;
         private readonly int _dummyPrimitive;
+        public static readonly Azure.Variant Null;
         public Variant(System.ArraySegment<byte> segment) { throw null; }
         public Variant(System.ArraySegment<char> segment) { throw null; }
         public Variant(bool value) { throw null; }
@@ -50,6 +51,7 @@ public readonly partial struct Variant
         public Variant(ushort value) { throw null; }
         public Variant(uint value) { throw null; }
         public Variant(ulong value) { throw null; }
+        public bool IsNull { get { throw null; } }
         public System.Type? Type { get { throw null; } }
         [System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.AggressiveInlining)]public T As<T>() { throw null; }
         public static Azure.Variant Create<T>(T value) { throw null; }
@@ -82,6 +84,7 @@ public readonly partial struct Variant
         public static explicit operator ulong? (in Azure.Variant value) { throw null; }
         public static explicit operator sbyte (in Azure.Variant value) { throw null; }
         public static explicit operator float (in Azure.Variant value) { throw null; }
+        public static explicit operator string (in Azure.Variant value) { throw null; }
         public static explicit operator ushort (in Azure.Variant value) { throw null; }
         public static explicit operator uint (in Azure.Variant value) { throw null; }
         public static explicit operator ulong (in Azure.Variant value) { throw null; }
@@ -114,6 +117,7 @@ public readonly partial struct Variant
         public static implicit operator Azure.Variant (ulong? value) { throw null; }
         public static implicit operator Azure.Variant (sbyte value) { throw null; }
         public static implicit operator Azure.Variant (float value) { throw null; }
+        public static implicit operator Azure.Variant (string value) { throw null; }
         public static implicit operator Azure.Variant (ushort value) { throw null; }
         public static implicit operator Azure.Variant (uint value) { throw null; }
         public static implicit operator Azure.Variant (ulong value) { throw null; }

sdk/core/Azure.Core.Experimental/api/Azure.Core.Experimental.netstandard2.0.cs

@@ -19,6 +19,7 @@ public readonly partial struct Variant
     {
         private readonly object _dummy;
         private readonly int _dummyPrimitive;
+        public static readonly Azure.Variant Null;
         public Variant(System.ArraySegment<byte> segment) { throw null; }
         public Variant(System.ArraySegment<char> segment) { throw null; }
         public Variant(bool value) { throw null; }
@@ -50,6 +51,7 @@ public readonly partial struct Variant
         public Variant(ushort value) { throw null; }
         public Variant(uint value) { throw null; }
         public Variant(ulong value) { throw null; }
+        public bool IsNull { get { throw null; } }
         public System.Type? Type { get { throw null; } }
         [System.Runtime.CompilerServices.MethodImpl(System.Runtime.CompilerServices.MethodImplOptions.AggressiveInlining)]public T As<T>() { throw null; }
         public static Azure.Variant Create<T>(T value) { throw null; }
@@ -82,6 +84,7 @@ public readonly partial struct Variant
         public static explicit operator ulong? (in Azure.Variant value) { throw null; }
         public static explicit operator sbyte (in Azure.Variant value) { throw null; }
         public static explicit operator float (in Azure.Variant value) { throw null; }
+        public static explicit operator string (in Azure.Variant value) { throw null; }
         public static explicit operator ushort (in Azure.Variant value) { throw null; }
         public static explicit operator uint (in Azure.Variant value) { throw null; }
         public static explicit operator ulong (in Azure.Variant value) { throw null; }
@@ -114,6 +117,7 @@ public readonly partial struct Variant
         public static implicit operator Azure.Variant (ulong? value) { throw null; }
         public static implicit operator Azure.Variant (sbyte value) { throw null; }
         public static implicit operator Azure.Variant (float value) { throw null; }
+        public static implicit operator Azure.Variant (string value) { throw null; }
         public static implicit operator Azure.Variant (ushort value) { throw null; }
         public static implicit operator Azure.Variant (uint value) { throw null; }
         public static implicit operator Azure.Variant (ulong value) { throw null; }

sdk/core/Azure.Core.Experimental/src/Variant/Variant.Null.cs

@@ -0,0 +1,19 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+namespace Azure
+{
+    public readonly partial struct Variant
+    {
+        /// <summary>
+        /// Null Variant.
+        /// </summary>
+        public static readonly Variant Null = new((object?)null);
+
+        /// <summary>
+        /// Indicates whether the Variant is null or has a value.
+        /// </summary>
+        /// <returns><code>true</code> if the Variant is <code>null</code>; <code>false</code> otherwise.</returns>
+        public bool IsNull => Type == null;
+    }
+}

sdk/core/Azure.Core.Experimental/src/Variant/Variant.cs

@@ -951,6 +951,20 @@ public Variant(ArraySegment<char> segment)
         public static explicit operator decimal?(in Variant value) => value.As<decimal?>();
         #endregion
 
+        #region String
+        /// <summary>
+        /// TBD.
+        /// </summary>
+        /// <param name="value"></param>
+        public static implicit operator Variant(string value) => new(value);
+
+        /// <summary>
+        /// TBD.
+        /// </summary>
+        /// <param name="value"></param>
+        public static explicit operator string(in Variant value) => value.As<string>();
+        #endregion
+
         #region T
         /// <summary>
         /// TBD.

sdk/core/Azure.Core.Experimental/tests/Variant/StoringArrays.cs

@@ -4,7 +4,7 @@
 using System;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringArrays
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringBoolean.cs

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringBoolean
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringByte.cs

@@ -2,7 +2,7 @@
 // Licensed under the MIT License.
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringByte
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringChar.cs

@@ -1,8 +1,9 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
+
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringChar
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringDateTime.cs

@@ -4,7 +4,7 @@
 using System;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringDateTime
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringDateTimeOffset.cs

@@ -4,7 +4,7 @@
 using System;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringDateTimeOffset
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringDecimal.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringDecimal
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringDouble.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringDouble
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringEnum.cs

@@ -5,7 +5,7 @@
 using System.Runtime.CompilerServices;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringEnum
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringFloat.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringFloat
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringInt.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringInt
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringLong.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringLong
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringNull.cs

@@ -4,7 +4,7 @@
 using System;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringNull
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringObject.cs

@@ -4,7 +4,7 @@
 using System;
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringObject
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringSByte.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringSByte
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringShort.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringShort
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringUInt.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringUInt
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringUShort.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringUShort
     {

sdk/core/Azure.Core.Experimental/tests/Variant/StoringUlong.cs

@@ -3,7 +3,7 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
     public class StoringULong
     {

sdk/core/Azure.Core.Experimental/tests/Variant/Creation.cs → sdk/core/Azure.Core.Experimental/tests/Variant/VariantCreation.cs

@@ -3,9 +3,9 @@
 
 using NUnit.Framework;
 
-namespace Azure
+namespace Azure.Core.Experimental.Tests
 {
-    public class Creation
+    public class VariantCreation
     {
         [Test]
         public void CreateIsAllocationFree()

sdk/core/Azure.Core.Experimental/tests/Variant/VariantUsage.cs

@@ -0,0 +1,32 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+using NUnit.Framework;
+
+namespace Azure.Core.Experimental.Tests
+{
+    public class VariantUsage
+    {
+        [Test]
+        public void CanUseVariantAsString()
+        {
+            Variant variant = "hi";
+
+            Assert.AreEqual("hi", (string)variant);
+
+            Assert.IsTrue("hi" == (string)variant);
+            Assert.IsTrue((string)variant == "hi");
+
+            Assert.AreEqual("hi", $"{(string)variant}");
+        }
+
+        [Test]
+        public void CanTestForNull()
+        {
+            Variant variant = Variant.Null;
+            Assert.True(variant.IsNull);
+
+            Assert.True(new Variant((object)null).IsNull);
+        }
+    }
+}