Swift方法文档 – 未在自动完成中显示
发布时间:2020-12-14 17:25:55 所属栏目:百科 来源:网络整理
导读:我正在记录我的 Swift方法如下: /// Extracts the server time from the API call response./// - parameter response: The HTTPURLResponse from which to extract the date./// - returns: The 'Date' header from the response,as a `Date` object./// -
我正在记录我的
Swift方法如下:
/// Extracts the server time from the API call response. /// - parameter response: The HTTPURLResponse from which to extract the date. /// - returns: The 'Date' header from the response,as a `Date` object. /// - throws: If the 'Date' header is not found,or cannot be parsed to a `Date` object. static func extractServerTimeFromResponse(_ response: HTTPURLResponse) throws -> Date { guard let serverTimeString = response.allHeaderFields["Date"] as? String else { throw RGOTimeSyncHelperError.invalidServerResponse } let formatter = DateFormatter() formatter.dateFormat = "EEE,dd MMM yyyy HH:mm:ss zzz" guard let serverTime = formatter.date(from: serverTimeString) else { throw RGOTimeSyncHelperError.dateParsingError } return serverTime } /// Calculates the offset of the local time compared to the server time. /// - parameter serverTime: The time from the server. /// - returns: The amount of seconds that need to be added to the client time,to match the server time. static func calculateOffset(serverTime: Date) -> Int { let localTime = Date() let offset = Calendar.current.dateComponents([.second],from: localTime,to: serverTime).second! return offset } /// Add an offset in seconds to a given date. /// - parameter date: The date to which to offset should be applied. /// - parameter bySeconds: The offset,in seconds,that will be applied to the given date. /// - returns: A new `Date` object,comprised of the given date,with the given offset applied. static func offset(date: Date,bySeconds offset: Int) -> Date { let offsetDate = Calendar.current.date(byAdding: .second,value: offset,to: date)! return offsetDate } 当我在任何地方双击方法签名时,Xcode会显示quickhelp面板,其中包含我输入的信息. 但是,当我开始键入方法签名并弹出自动完成时,它不会像在Apple的API中那样在自动完成框的底部显示此信息. 我的评论语法在哪里,我错了? 解决方法
原因是Xcode从单独的doc-set解析popover中显示的文档,而不是从类文件本身解析.
看看这里:https://stackoverflow.com/a/43982094/1415898获得更完整的答案. (编辑:李大同) 【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容! |