Existem algumas nuances para diferentes casos de uso, mas geralmente um sublinhado significa "ignorar isso".
Ao declarar uma nova função, um sublinhado informa ao Swift que o parâmetro não deve ter rótulo quando chamado - é o caso que você está vendo. Uma declaração de função mais completa se parece com isso:
func myFunc(label name: Int) // call it like myFunc(label: 3)
"label" é um rótulo de argumento e deve estar presente quando você chama a função. (E, desde o Swift 3, os rótulos são obrigatórios para todos os argumentos por padrão.) "Name" é o nome da variável para esse argumento que você usa dentro da função. Um formulário mais curto se parece com isso:
func myFunc(name: Int) // call it like myFunc(name: 3)
Este é um atalho que permite usar a mesma palavra para o rótulo de argumento externo e o nome do parâmetro interno. É equivalente a func myFunc(name name: Int)
.
Se você deseja que sua função possa ser chamada sem rótulos de parâmetro, use o sublinhado _
para fazer com que o rótulo seja nada / ignorado. (Nesse caso, você deve fornecer um nome interno se quiser poder usar o parâmetro.)
func myFunc(_ name: Int) // call it like myFunc(3)
Em uma declaração de atribuição, um sublinhado significa "não atribuir a nada". Você pode usar isso se desejar chamar uma função que retorne um resultado, mas não se importe com o valor retornado.
_ = someFunction()
Ou, como no artigo ao qual você vinculou, ignorar um elemento de uma tupla retornada:
let (x, _) = someFunctionThatReturnsXandY()
Ao escrever um fechamento que implementa algum tipo de função definido, você pode usar o sublinhado para ignorar determinados parâmetros.
PHPhotoLibrary.performChanges( { /* some changes */ },
completionHandler: { success, _ in // don't care about error
if success { print("yay") }
})
Da mesma forma, ao declarar uma função que adota um protocolo ou substitui um método de superclasse, você pode usar os nomes de_
parâmetros para ignorá- los . Como o protocolo / superclasse também pode definir que o parâmetro não possui rótulo, você pode até acabar com dois sublinhados seguidos.
class MyView: NSView {
override func mouseDown(with _: NSEvent) {
// don't care about event, do same thing for every mouse down
}
override func draw(_ _: NSRect) {
// don't care about dirty rect, always redraw the whole view
}
}
Um pouco relacionado aos dois últimos estilos: ao usar uma construção de controle de fluxo que liga uma variável / constante local, você pode usá _
-la para ignorá-la. Por exemplo, se você deseja iterar uma sequência sem precisar acessar seus membros:
for _ in 1...20 { // or 0..<20
// do something 20 times
}
Se você estiver vinculando casos de tupla em uma instrução switch, o sublinhado poderá funcionar como um curinga, como neste exemplo (abreviado de um na linguagem de programação Swift ):
switch somePoint { // somePoint is an (Int, Int) tuple
case (0, 0):
print("(0, 0) is at the origin")
case (_, 0):
print("(\(somePoint.0), 0) is on the x-axis")
case (0, _):
print("(0, \(somePoint.1)) is on the y-axis")
default:
print("(\(somePoint.0), \(somePoint.1)) isn't on an axis")
}
Uma última coisa que não é bem relacionado, mas que vou incluir desde (como observado por comentários) parece levar as pessoas aqui: Um sublinhado em um identificador - por exemplo var _foo
, func do_the_thing()
, struct Stuff_
- não significa nada em particular a Swift, mas tem alguns usos entre programadores.
Sublinhados em um nome são uma opção de estilo, mas não são preferidos na comunidade Swift, que possui fortes convenções sobre o uso de UpperCamelCase para tipos e lowerCamelCase para todos os outros símbolos.
A prefixação ou o sufixo de um nome de símbolo com sublinhado é uma convenção de estilo, usada historicamente para distinguir símbolos particulares / somente para uso interno da API exportada. No entanto, o Swift possui modificadores de acesso para isso, portanto essa convenção geralmente é vista como não idiomática no Swift.
Alguns símbolos com prefixos de sublinhado duplo ( func __foo()
) estão nas profundezas dos SDKs da Apple: Estes são símbolos (Obj) C importados para o Swift usando o NS_REFINED_FOR_SWIFT
atributo A Apple usa isso quando deseja criar uma versão "mais Swifty" de uma API (Obj) C - por exemplo, para transformar um método independente de tipo em um método genérico . Eles precisam usar a API importada para fazer com que a versão refinada do Swift funcione; portanto, eles usam isso __
para mantê-la disponível enquanto ocultam a maioria das ferramentas e documentação.