using System;
using System.Globalization;
using System.Runtime.Serialization;

namespace LibGit2Sharp
{
    /// <summary>
    /// The exception that is thrown when the provided specification cannot uniquely identify a reference, an object or a path.
    /// </summary>
    [Serializable]
    public class AmbiguousSpecificationException : LibGit2SharpException
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="AmbiguousSpecificationException"/> class.
        /// </summary>
        public AmbiguousSpecificationException()
        { }

        /// <summary>
        /// Initializes a new instance of the <see cref="AmbiguousSpecificationException"/> class with a specified error message.
        /// </summary>
        /// <param name="message">A message that describes the error.</param>
        public AmbiguousSpecificationException(string message)
            : base(message)
        { }

        /// <summary>
        /// Initializes a new instance of the <see cref="AmbiguousSpecificationException"/> class with a specified error message.
        /// </summary>
        /// <param name="cultureInfo">An object that supplies culture-specific formatting information.</param>
        /// <param name="format">A composite format string for use in <see cref="String.Format(IFormatProvider, string, object[])"/>.</param>
        /// <param name="args">An object array that contains zero or more objects to format.</param>
        public AmbiguousSpecificationException(CultureInfo cultureInfo, string format, params object[] args)
            : base(String.Format(cultureInfo, format, args))
        {
        }

        /// <summary>
        /// Initializes a new instance of the <see cref="AmbiguousSpecificationException"/> class with a specified error message and a reference to the inner exception that is the cause of this exception.
        /// </summary>
        /// <param name="message">The error message that explains the reason for the exception.</param>
        /// <param name="innerException">The exception that is the cause of the current exception. If the <paramref name="innerException"/> parameter is not a null reference, the current exception is raised in a catch block that handles the inner exception.</param>
        public AmbiguousSpecificationException(string message, Exception innerException)
            : base(message, innerException)
        { }

        /// <summary>
        /// Initializes a new instance of the <see cref="AmbiguousSpecificationException"/> class with a serialized data.
        /// </summary>
        /// <param name="info">The <see cref="SerializationInfo"/> that holds the serialized object data about the exception being thrown.</param>
        /// <param name="context">The <see cref="StreamingContext"/> that contains contextual information about the source or destination.</param>
        protected AmbiguousSpecificationException(SerializationInfo info, StreamingContext context)
            : base(info, context)
        { }
    }
}
