Skip to content

Latest commit

 

History

History
40 lines (22 loc) · 1.87 KB

README.md

File metadata and controls

40 lines (22 loc) · 1.87 KB
Raw

LeftPad

This is a sample package to demonstrate adding additional metadata to a Package.swift file. It should never be used in production. I implemented a leftPad extension to String purely because of a little piece of internet history.

Try LeftPad in a Swift Playground

Usage

This screenshot should show you everything you need to know:

Screenshot of a Swift Playground with LeftPad in use.

Implementation

The algorithm used to pad the left hand side of a string with spaces is highly complex and delicate. If you must look, please treat the information in the source file with care. With great power comes great responsibility.

Revision History

  • 1.0.0 - The original, and what many consider to be the best release.
  • 1.0.1 - Added a testimonial to the README file, increasing padding performance by 0%.
  • 1.1.0 - Oh my, what a release this was. Swift 4.2 support, bug fixes (yes, really), and so much more.
  • 2.0 - The "not really a release", release to test partial semantic version numbers.
  • 2.1.0 - The "let's get LeftPad back on a semantic version" release. Also added a .spi.yml for DocC generation.

Testimonials

"This is a very good package." -- Tim Cook, Apple

How does it work?

I'm glad you asked! The algorithm is complex and could not possibly be described in words, so here is the raw code:

LeftPad/Sources/LeftPad/LeftPad.swift

Lines 1 to 7 in bbf9831

extension String {
public func leftPad(length: Int) -> String {
guard self.count < length else { return self }
return repeatElement(" ", count: length - self.count) + self
}
}

Demonstration of usage

We have included a step-by-step tutorial on how to use this package:

Screenshot.2024-09-02.at.12.51.33.mp4