song/AudioFormatFilter: add mask support

doc/protocol.xml

@@ -276,6 +276,14 @@
           </para>
         </listitem>
 
+        <listitem>
+          <para>
+            "<code>(AudioFormat =~ 'SAMPLERATE:BITS:CHANNELS')</code>":
+            matches the audio format with the given mask (i.e. one
+            or more attributes may be "<code>*</code>").
+          </para>
+        </listitem>
+
         <listitem>
           <para>
             "<code>(!EXPRESSION)</code>": negate an expression.

src/song/AudioFormatSongFilter.cxx

@@ -24,13 +24,14 @@
 std::string
 AudioFormatSongFilter::ToExpression() const noexcept
 {
-	// TODO: support mask
-	return std::string("(AudioFormat == \"") + ToString(value).c_str() + "\")";
+	return std::string("(AudioFormat ") +
+		(value.IsFullyDefined() ? "==" : "=~") +
+		" \"" + ToString(value).c_str() + "\")";
 }
 
 bool
 AudioFormatSongFilter::Match(const LightSong &song) const noexcept
 {
-	// TODO: support mask
-	return song.audio_format == value;
+	return song.audio_format.IsDefined() &&
+		song.audio_format.MatchMask(value);
 }

src/song/Filter.cxx

@@ -245,14 +245,18 @@ SongFilter::ParseExpression(const char *&s, bool fold_case)
 
 		return std::make_unique<BaseSongFilter>(std::move(value));
 	} else if (type == LOCATE_TAG_AUDIO_FORMAT) {
-		if (s[0] != '=' || s[1] != '=')
-			throw std::runtime_error("'==' expected");
+		bool mask;
+		if (s[0] == '=' && s[1] == '=')
+			mask = false;
+		else if (s[0] == '=' && s[1] == '~')
+			mask = true;
+		else
+			throw std::runtime_error("'==' or '=~' expected");
 
 		s = StripLeft(s + 2);
 
-		// TODO: support mask
 		const auto value = ParseAudioFormat(ExpectQuoted(s).c_str(),
-						    false);
+						    mask);
 
 		if (*s != ')')
 			throw std::runtime_error("')' expected");