/// <summary>
/// Reads the <paramref name="type"/> tag from the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to read tags from.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to read.</param>
/// <returns>Returns the value of the <paramref name="type"/> tag.</returns>
public string GetString(IntPtr sndfile, LibsndfileStringType type)
{
if (sndfile == IntPtr.Zero)
{
throw new ArgumentException("File handle is invalid/closed.");
}
return(m_Api.GetString(sndfile, type));
}
/// <summary>
/// Writes the <paramref name="value"/> to the ID3 tag of <paramref name="type"/>
/// in the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to write tags to.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to change.</param>
/// <param name="value">New value of <see cref="LibsndfileStringType"/> tag.</param>
/// <returns>Returns an <see cref="LibsndfileError"/> error code.</returns>
public LibsndfileError SetString(IntPtr sndfile, LibsndfileStringType type, string value)
{
if (sndfile == IntPtr.Zero)
{
throw new ArgumentException("File handle is invalid/closed.");
}
if (string.IsNullOrEmpty(value))
{
throw new ArgumentNullException("value", "Value cannot be null/empty.");
}
var retval = m_Api.SetString(sndfile, type, value);
if (retval != LibsndfileError.NoError)
{
throw new LibsndfileException(string.Format("SetString returned error code {0}.", retval));
}
return(retval);
}
internal static extern LibsndfileError sf_set_string(IntPtr sndfile, LibsndfileStringType type, string value);
internal static extern IntPtr sf_get_string(IntPtr sndfile, LibsndfileStringType type);
internal static extern LibsndfileError sf_set_string(IntPtr sndfile, LibsndfileStringType type, string value);
internal static extern IntPtr sf_get_string(IntPtr sndfile, LibsndfileStringType type);
/// <summary>
/// Writes the <paramref name="value"/> to the ID3 tag of <paramref name="type"/>
/// in the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to write tags to.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to change.</param>
/// <param name="value">New value of <see cref="LibsndfileStringType"/> tag.</param>
/// <returns>Returns an <see cref="LibsndfileError"/> error code.</returns>
public LibsndfileError SetString(IntPtr sndfile, LibsndfileStringType type, string value)
{
return LibsndfileApiNative.sf_set_string(sndfile, type, value);
}
/// <summary>
/// Reads the <paramref name="type"/> tag from the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to read tags from.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to read.</param>
/// <returns>Returns the value of the <paramref name="type"/> tag.</returns>
public string GetString(IntPtr sndfile, LibsndfileStringType type)
{
var retval = LibsndfileApiNative.sf_get_string(sndfile, type);
return m_Marshaller.MemoryHandleToString(retval);
}
/// <summary>
/// Writes the <paramref name="value"/> to the ID3 tag of <paramref name="type"/>
/// in the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to write tags to.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to change.</param>
/// <param name="value">New value of <see cref="LibsndfileStringType"/> tag.</param>
/// <returns>Returns an <see cref="LibsndfileError"/> error code.</returns>
public LibsndfileError SetString(IntPtr sndfile, LibsndfileStringType type, string value)
{
return(LibsndfileApiNative.sf_set_string(sndfile, type, value));
}
/// <summary>
/// Reads the <paramref name="type"/> tag from the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to read tags from.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to read.</param>
/// <returns>Returns the value of the <paramref name="type"/> tag.</returns>
public string GetString(IntPtr sndfile, LibsndfileStringType type)
{
var retval = LibsndfileApiNative.sf_get_string(sndfile, type);
return(m_Marshaller.MemoryHandleToString(retval));
}
/// <summary>
/// Writes the <paramref name="value"/> to the ID3 tag of <paramref name="type"/>
/// in the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to write tags to.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to change.</param>
/// <param name="value">New value of <see cref="LibsndfileStringType"/> tag.</param>
/// <returns>Returns an <see cref="LibsndfileError"/> error code.</returns>
public LibsndfileError SetString(IntPtr sndfile, LibsndfileStringType type, string value)
{
if (sndfile == IntPtr.Zero)
throw new ArgumentException("File handle is invalid/closed.");
if (string.IsNullOrEmpty(value))
throw new ArgumentNullException("value", "Value cannot be null/empty.");
var retval = m_Api.SetString(sndfile, type, value);
if (retval != LibsndfileError.NoError)
throw new LibsndfileException(string.Format("SetString returned error code {0}.", retval));
return retval;
}
/// <summary>
/// Reads the <paramref name="type"/> tag from the <paramref name="sndfile"/> audio file.
/// </summary>
/// <param name="sndfile">Audio file to read tags from.</param>
/// <param name="type"><see cref="LibsndfileStringType"/> tag to read.</param>
/// <returns>Returns the value of the <paramref name="type"/> tag.</returns>
public string GetString(IntPtr sndfile, LibsndfileStringType type)
{
if (sndfile == IntPtr.Zero)
throw new ArgumentException("File handle is invalid/closed.");
return m_Api.GetString(sndfile, type);
}
