SALE: Save 50% on all my books and bundles >>

What are inout parameters?

Swift version: 5.1

Paul Hudson    @twostraws   

When you pass value types as parameters into a function, they are constants and so can’t be modified. Sometimes it would be convenient to change this so you can modify the values, and that’s what inout does for us: it lets us modify parameters inside a function, and have those changes persist outside the function.

For example, we could write a function that accepts a number and doubles it:

func double(_ number: inout Int) {
    number *= 2
}

That doesn’t return a value – it modifies the value that was passed in directly.

When it comes to calling functions with inout parameters, Swift has two rules: we must pass in variables, and we also need to use & before the parameter name to acknowledge that it might be changed.

So, we would call double() like this:

var number = 5
double(&number)
print(number)

That will print 10.

inout parameters are more common than you might realize. For example, if you use += to append one string to another, it uses inout to modify the string in place.

Hacking with Swift is sponsored by Instabug

SPONSORED Catch bugs as soon as they happen and know exactly why a crash occurred by integrating Instabug's SDK in one minute. You will automatically receive device data, network logs, and reproduction steps with every bug and crash report.

Learn more and get started for free

Sponsor Hacking with Swift and reach the world's largest Swift community!

Snapthread is a casual video editor and slideshow maker that makes discovering, compiling and sharing your favorite memories effortless.

Available from iOS 8.0

Similar solutions…

About the Swift Knowledge Base

This is part of the Swift Knowledge Base, a free, searchable collection of solutions for common iOS questions.

BUY OUR BOOKS
Buy Pro Swift Buy Swift Design Patterns Buy Testing Swift Buy Hacking with iOS Buy Swift Coding Challenges Buy Swift on Sundays Volume One Buy Server-Side Swift (Vapor Edition) Buy Advanced iOS Volume One Buy Advanced iOS Volume Two Buy Advanced iOS Volume Three Buy Hacking with watchOS Buy Hacking with tvOS Buy Hacking with macOS Buy Dive Into SpriteKit Buy Swift in Sixty Seconds Buy Objective-C for Swift Developers Buy Server-Side Swift (Kitura Edition) Buy Beyond Code

Was this page useful? Let us know!

Average rating: 4.5/5