Tour of Scala

Сопоставление с примером

Language

Сопоставление с примером (Pattern matching) - это механизм сравнения значений с определенным примером. При успешном совпадении значение может быть разложено на составные части. Мы рассматриваем сопоставление с примером, как более мощную версию switch оператора из Java. Eго также можно использовать вместо серии if/else выражений.

Синтаксис

Синтаксис сопоставления с примером состоит из значения, ключевого слова match (сопоставить) и по крайней мере, одного пункта с примером case, с которым мы хотим сопоставить наше значение.

import scala.util.Random val x: Int = Random.nextInt(10) x match { case 0 => "zero" case 1 => "one" case 2 => "two" case _ => "other" } 
import scala.util.Random val x: Int = Random.nextInt(10) x match case 0 => "zero" case 1 => "one" case 2 => "two" case _ => "other" 

Значение константы x выше представляет собой случайное целое число от 0 до 9. x становится левым операндом оператора match, а справа - выражением с четырьмя примерами (называемые еще вариантами). Последний вариант _ - позволяет “поймать все оставшиеся варианты” т. е. для любого числа больше 2.

Сопоставление с примером возвращает значение.

def matchTest(x: Int): String = x match { case 1 => "one" case 2 => "two" case _ => "other" } matchTest(3) // выводит "other" matchTest(1) // выводит "one" 
def matchTest(x: Int): String = x match case 1 => "one" case 2 => "two" case _ => "other" matchTest(3) // выводит "other" matchTest(1) // выводит "one" 

Это сопоставляющее выражение имеет тип String, так как все варианты сопоставления возвращают String. Поэтому функция matchTest возвращает String.

Сопоставление с классами образцами

Классы образцы особенно полезны для сопоставления.

sealed trait Notification case class Email(sender: String, title: String, body: String) extends Notification case class SMS(caller: String, message: String) extends Notification case class VoiceRecording(contactName: String, link: String) extends Notification 

Notification - запечатанный трейт, от которого наследуются три конкретных типа реализаций классов образцов Email, SMS, и VoiceRecording. Теперь мы можем делать сопоставление с примером используя в качестве примера один из этих классов образцов. При сопоставлении с классом образцом мы можем сразу извлекать параметры из которых состоит класс (благодаря автоматическому использованию объекта экстрактора):

def showNotification(notification: Notification): String = { notification match { case Email(sender, title, _) => s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" case VoiceRecording(name, link) => s"You received a Voice Recording from $name! Click the link to hear it: $link" } } val someSms = SMS("12345", "Are you there?") val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") println(showNotification(someSms)) // выводит "You got an SMS from 12345! Message: Are you there?" println(showNotification(someVoiceRecording)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" 
def showNotification(notification: Notification): String = notification match case Email(sender, title, _) => s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" case VoiceRecording(name, link) => s"You received a Voice Recording from $name! Click the link to hear it: $link" val someSms = SMS("12345", "Are you there?") val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") println(showNotification(someSms)) // выводит "You got an SMS from 12345! Message: Are you there?" println(showNotification(someVoiceRecording)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" 

Функция showNotification принимает в качестве параметра абстрактный тип Notification который проверяет по образцам (т.е. выясняет, является ли он классом Email, SMS или VoiceRecording). В case Email(email, title, _)поля email и title используются в возвращаемом значении, а вот поле body игнорируется благодаря символу _.

Ограждения примеров

Ограждения примеров - это просто логические выражения, которые используются для того, чтобы сделать выбор более специфичным (убрать лишние варианты). Просто добавьте if <логическое выражение> после примера.

def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = { notification match { case Email(sender, _, _) if importantPeopleInfo.contains(sender) => "You got an email from special someone!" case SMS(number, _) if importantPeopleInfo.contains(number) => "You got an SMS from special someone!" case other => showNotification(other) // в этом варианте считается подходящими параметры любого типа. Значит этот вариант выполняется во всех случаях и передает исходный параметр в функцию showNotification } } val importantPeopleInfo = Seq("867-5309", "[email protected]") val someSms = SMS("123-4567", "Are you there?") val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") val importantEmail = Email("[email protected]", "Drinks tonight?", "I'm free after 5!") val importantSms = SMS("867-5309", "I'm here! Where are you?") println(showImportantNotification(someSms, importantPeopleInfo)) // выводит "You got an SMS from 123-4567! Message: Are you there?" println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" println(showImportantNotification(importantEmail, importantPeopleInfo)) // выводит "You got an email from special someone!" println(showImportantNotification(importantSms, importantPeopleInfo)) // выводит "You got an SMS from special someone!" 
def showImportantNotification(notification: Notification, importantPeopleInfo: Seq[String]): String = notification match case Email(sender, _, _) if importantPeopleInfo.contains(sender) => "You got an email from special someone!" case SMS(number, _) if importantPeopleInfo.contains(number) => "You got an SMS from special someone!" case other => showNotification(other) // в этом варианте считается подходящими параметры любого типа. Значит этот вариант выполняется во всех случаях и передает исходный параметр в функцию showNotification val importantPeopleInfo = Seq("867-5309", "[email protected]") val someSms = SMS("123-4567", "Are you there?") val someVoiceRecording = VoiceRecording("Tom", "voicerecording.org/id/123") val importantEmail = Email("[email protected]", "Drinks tonight?", "I'm free after 5!") val importantSms = SMS("867-5309", "I'm here! Where are you?") println(showImportantNotification(someSms, importantPeopleInfo)) // выводит "You got an SMS from 123-4567! Message: Are you there?" println(showImportantNotification(someVoiceRecording, importantPeopleInfo)) // выводит "You received a Voice Recording from Tom! Click the link to hear it: voicerecording.org/id/123" println(showImportantNotification(importantEmail, importantPeopleInfo)) // выводит "You got an email from special someone!" println(showImportantNotification(importantSms, importantPeopleInfo)) // выводит "You got an SMS from special someone!" 

В варианте case Email(email, _, _) if importantPeopleInfo.contains(email), пример сравнивается только если email находится в списке importantPeopleInfo.

Сопоставление только с типом

Вы можете сопоставлять только по типу как в примере:

sealed trait Device case class Phone(model: String) extends Device { def screenOff = "Turning screen off" } case class Computer(model: String) extends Device { def screenSaverOn = "Turning screen saver on..." } def goIdle(device: Device): String = device match { case p: Phone => p.screenOff case c: Computer => c.screenSaverOn } 
sealed trait Device case class Phone(model: String) extends Device: def screenOff = "Turning screen off" case class Computer(model: String) extends Device: def screenSaverOn = "Turning screen saver on..." def goIdle(device: Device): String = device match case p: Phone => p.screenOff case c: Computer => c.screenSaverOn 

метод goIdle реализует изменение поведения в зависимости от типа Device. По соглашению в качестве названия варианта используется первая буква типа (в данном случае p и c).

Запечатанные типы

Вы могли заметить, что в приведенных выше примерах базовые типы уточняются с помощью ключевого слова sealed. Это обеспечивает дополнительную безопасность, поскольку компилятор проверяет, указаны ли все случаи в выражении match, если базовым типом является sealed.

Например, в методе showNotification, определенном выше, если мы “забудем” один пример, скажем, VoiceRecording, компилятор выдаст предупреждение:

def showNotification(notification: Notification): String = { notification match { case Email(sender, title, _) => s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" } } 
def showNotification(notification: Notification): String = notification match case Email(sender, title, _) => s"You got an email from $sender with title: $title" case SMS(number, message) => s"You got an SMS from $number! Message: $message" 

Это определение выдает следующее предупреждение:

match may not be exhaustive. It would fail on pattern case: VoiceRecording(_, _) 

Компилятор даже предоставляет примеры входных данных, которые потерпят неудачу при сопоставлении!

С другой стороны, проверка полноты требует, чтобы вы определили все подтипы базового типа в том же файле, что и базовый тип (иначе бы компилятор не знал все возможные варианты). Например, если вы попытаетесь определить новый тип Notification вне файла, который определяет sealed trait Notification, это приведет к ошибке компиляции:

case class Telepathy(message: String) extends Notification ^ Cannot extend sealed trait Notification in a different source file 

Замечания

Сопоставление с примером наиболее полезно для сопоставления алгебраических типов, выраженных через классы образцы. Scala также позволяет создавать образцы независимо от классов образцов, через использование метода unapply в объектах экстракторах.

Дополнительные ресурсы

  • Дополнительная информация о сопоставлении с примером доступна в книге Scala.

Contributors to this page: