Comentarios en Swift

¿Cómo se introducen comentarios en Swift?

  • La primera sería para introducir un comentario de una sola linea.
// Esto es una forma de introducir un comentario
  • La segunda sería para introducir más de una linea comentada.
/*Si queremos comentar más de una linea para explicar másy no alargar una linea 
*/

La longitud de un nombre de una variable debería ser proporcional a su alcance. La longitud de un nombre de una función o de una clase es la inversa.

  • Si vamos a crear una variable global, intentaremos ser lo más específicos posibles, es decir, su nombre será lo suficientemente largo que explique lo que representa.
// columns in table view ....
let columns: Int = 2
let columnsInTableView: Int = 2

Condiciones casi infinitas

// If both users are near and they have the same scoreif process(a, b) < .near && calculate(a) == calculate(b) {    doSometing()}
if bothUsersAreNearAndHaveSameScore() {
doSomething()
}func bothUsersAreNearAndHaveSameScore() -> Bool {
process(a, b) < .near && calculate(a) == calculate(b)
}

Entonces, ¿dónde podemos crear comentarios?

  • Si nuestro código es una librería que va a ser usado por un equipo externo al nuestro, te recomiendo que crees comentarios a modo de documentación para luego generarla.
/// This function calculate something  
///
/// - Parameters:
/// - name: The name of the function.
/// - request: The request.
func calculateSomething(name: String, request: [String: Any])
  • En Swift podemos poner marcas en el código.
// MARK: - Life Cycle

¿Otros sitios?

--

--

--

mobile developer

Love podcasts or audiobooks? Learn on the go with our new app.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store
Albert Gil Escura

Albert Gil Escura

mobile developer

More from Medium

Live Preview UIKit in Swift

How to add Lottie Animations in iOS apps?

Capture Videos on a Custom Screen | Swift | Xcode