mirror of
https://github.com/apple/swift.git
synced 2025-12-21 12:14:44 +01:00
559092bbf2
- Expand pre-example explanations - Update documentation for SE-0118 - Removing remaining 'iff' usage - Revise Array discussion - Fix formIndex(_:offsetBy) parameter formatting - Improve index/formIndex(_:offsetBy:(limitedBy:)?) discussion - Update Quick Look discussions - Fixes grammar inconsistencies - Adds parameter / return documentation - Adds and expands on examples - Revises AnyObject discussion for new `id` bridging rules - Revise readLine, print, and assertion functions - Add missing docs to String index-moving methods
74 lines
2.5 KiB
Swift
74 lines
2.5 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
//
|
|
// This source file is part of the Swift.org open source project
|
|
//
|
|
// Copyright (c) 2014 - 2016 Apple Inc. and the Swift project authors
|
|
// Licensed under Apache License v2.0 with Runtime Library Exception
|
|
//
|
|
// See http://swift.org/LICENSE.txt for license information
|
|
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
import SwiftShims
|
|
|
|
/// Returns a string read from standard input through the end of the current
|
|
/// line or until EOF is reached.
|
|
///
|
|
/// Standard input is interpreted as `UTF-8`. Invalid bytes are replaced by
|
|
/// Unicode [replacement characters][rc].
|
|
///
|
|
/// [rc]:
|
|
/// http://en.wikipedia.org/wiki/Specials_(Unicode_block)#Replacement_character
|
|
///
|
|
/// - Parameter strippingNewline: If `true`, newline characters and character
|
|
/// combinations are stripped from the result; otherwise, newline characters
|
|
/// or character combinations are preserved. The default is `true`.
|
|
/// - Returns: The string of characters read from standard input. If EOF has
|
|
/// already been reached when `readLine()` is called, the result is `nil`.
|
|
public func readLine(strippingNewline: Bool = true) -> String? {
|
|
var linePtrVar: UnsafeMutablePointer<UInt8>? = nil
|
|
var readBytes = swift_stdlib_readLine_stdin(&linePtrVar)
|
|
if readBytes == -1 {
|
|
return nil
|
|
}
|
|
_sanityCheck(readBytes >= 0,
|
|
"unexpected return value from swift_stdlib_readLine_stdin")
|
|
if readBytes == 0 {
|
|
return ""
|
|
}
|
|
|
|
let linePtr = linePtrVar!
|
|
if strippingNewline {
|
|
// FIXME: Unicode conformance. To fix this, we need to reimplement the
|
|
// code we call above to get a line, since it will only stop on LF.
|
|
//
|
|
// <rdar://problem/20013999> Recognize Unicode newlines in readLine()
|
|
//
|
|
// Recognize only LF and CR+LF combinations for now.
|
|
let cr = UInt8(ascii: "\r")
|
|
let lf = UInt8(ascii: "\n")
|
|
if readBytes == 1 && linePtr[0] == lf {
|
|
return ""
|
|
}
|
|
if readBytes >= 2 {
|
|
switch (linePtr[readBytes - 2], linePtr[readBytes - 1]) {
|
|
case (cr, lf):
|
|
readBytes -= 2
|
|
break
|
|
case (_, lf):
|
|
readBytes -= 1
|
|
break
|
|
default:
|
|
()
|
|
}
|
|
}
|
|
}
|
|
let result = String._fromCodeUnitSequenceWithRepair(UTF8.self,
|
|
input: UnsafeMutableBufferPointer(
|
|
start: linePtr,
|
|
count: readBytes)).0
|
|
_swift_stdlib_free(linePtr)
|
|
return result
|
|
}
|