Menu
×
   ❮     
HTML CSS JAVASCRIPT SQL PYTHON JAVA PHP HOW TO W3.CSS C C++ C# BOOTSTRAP REACT MYSQL JQUERY EXCEL XML DJANGO NUMPY PANDAS NODEJS DSA TYPESCRIPT ANGULAR ANGULARJS GIT POSTGRESQL MONGODB ASP AI R GO KOTLIN SWIFT SASS VUE GEN AI SCIPY CYBERSECURITY DATA SCIENCE INTRO TO PROGRAMMING BASH RUST

Swift Basics

Swift HOME Swift Intro Swift Get Started Swift Syntax Swift Statements Swift Output Swift Comments Swift Variables Swift Data Types Swift Type Casting Swift Operators Swift Strings Swift Arrays Swift Ranges Swift If...Else Swift Switch Swift While Loop Swift For Loop Swift Break/Continue Swift Collections

Swift Types & Functions

Swift Functions Swift Optionals Swift Enums & Patterns Swift Closures Tuples & Type Aliases

Swift Object Model

Swift OOP Swift Inheritance Swift Polymorphism Swift Protocols Swift Generics Swift Extensions Access Control Initializers Deinitializers Value Semantics & COW Equatable & Comparable

Swift Robustness & Async

Swift Error Handling Swift Concurrency Swift Memory

Swift Tooling

Swift Package Manager

SwiftUI Basics

SwiftUI Intro iOS Project Setup SwiftUI Layout SwiftUI Navigation SwiftUI Data Flow SwiftUI Lists & Forms SwiftUI Animations SwiftUI Gestures SwiftUI Modifiers & ViewBuilder SwiftUI Previews SwiftUI Accessibility SwiftUI Styling & Theming

SwiftUI Data & Architecture

Networking Persistence Persistence (Core Data) MVVM Architecture AppStorage & SceneStorage Testing SwiftUI

iOS Capabilities

Privacy & Permissions Push Notifications Widgets & Extensions Background Work Core Location App Clips Keychain Basics CloudKit File System Background URLSession MapKit

iOS Quality & Compliance

Localization Accessibility App Privacy In-App Purchases Analytics & Reporting Testing with XCTest

iOS Release & Distribution

Assets & App Icons Signing & Distribution TestFlight & App Store Ship Your First App

Swift Exercises

Swift Exercises Swift Quiz

Swift Initializers


Swift Initializers

Create and customize object setup with designated, convenience, and memberwise initializers.


Memberwise and Custom Init

Structs get a memberwise initializer by default.

You can also define custom initializers.

Syntax: init(params) { self.prop = ... }

Example

struct User { var name: String; var age: Int }
let a = User(name: "Morgan", age: 30) // memberwise

struct Point {
  var x: Int, y: Int
  init(_ x: Int, _ y: Int) { self.x = x; self.y = y }
}
let p = Point(1, 2)

Try it Yourself »

This example shows a memberwise initializer for a simple struct and a custom initializer with positional parameters.


Class Designated vs Convenience

Classes use designated initializers to fully initialize stored properties and convenience initializers to provide shortcuts.

Syntax:

  • init(...) (designated)
  • convenience init(...) (must call self.init)

Example

class Person {
  let name: String
  let age: Int
  init(name: String, age: Int) {
    self.name = name; self.age = age
  }
  convenience init(name: String) { self.init(name: name, age: 0) }
}

let p1 = Person(name: "Robin", age: 30)
let p2 = Person(name: "Elisabeth")

Try it Yourself »

The convenience initializer provides a default for age by delegating to the designated initializer.



Failable and Throwing Init

Use failable initializers to return nil on invalid input; use throwing initializers to signal errors.

Syntax:

  • init?
  • init throws

Example

struct Email {
  let value: String
  init?(_ s: String) { if s.contains("@") { value = s } else { return nil } }
}

enum InitError: Error { case invalid }
struct Port {
  let number: Int
  init(_ n: Int) throws { guard (1...65535).contains(n) else { throw InitError.invalid }; number = n }
}

Try it Yourself »

This example shows a failable initializer for an email and a throwing initializer for a port range check.

Tip: Prefer memberwise initializers for simple value types; add validation in custom initializers.



×

Contact Sales

If you want to use W3Schools services as an educational institution, team or enterprise, send us an e-mail:
sales@w3schools.com

Report Error

If you want to report an error, or if you want to make a suggestion, send us an e-mail:
help@w3schools.com

W3Schools is optimized for learning and training. Examples might be simplified to improve reading and learning. Tutorials, references, and examples are constantly reviewed to avoid errors, but we cannot warrant full correctness of all content. While using W3Schools, you agree to have read and accepted our terms of use, cookie and privacy policy.

Copyright 1999-2025 by Refsnes Data. All Rights Reserved. W3Schools is Powered by W3.CSS.