超碰国产伊人,夜夜爽中文字幕久久

前言

碼農(nóng)總是在搬磚，日復(fù)一日，年復(fù)一年，有的時(shí)候都會麻木。

代碼大家都會寫，但是把注釋寫好卻是一個(gè)技術(shù)活。

下面這段話，很好的說明了寫好注釋的感覺：

注釋代碼很像清潔你的廁所——你不想干，但如果你做了，這絕對會給你和你的客人帶來更愉悅的體驗(yàn)?！?Ryan Campbell

今天給大家聊的就是在Xcode中，代碼注釋編寫小技巧。

Objective-C的代碼注釋

很久很久以前，在Xcode還可以安裝插件的時(shí)代，iOSer都通過VVDocument來編寫代碼注釋的。

代碼注釋的風(fēng)格一般都是這樣的，代碼出自IQKeyboardManager/IQBarButtonItem

如果你正在面試，或者正準(zhǔn)備跳槽，不妨看看我精心總結(jié)的面試資料：https://gitee.com/Mcci7/i-oser 來獲取一份詳細(xì)的大廠面試資料為你的跳槽加薪多一份保障

#import <UIKit/UIBarButtonItem.h>

@class NSInvocation;

/**
 IQBarButtonItem used for IQToolbar.
 */

@interface IQBarButtonItem : UIBarButtonItem

/**
 Boolean to know if it's a system item or custom item
 */
@property (nonatomic, readonly) BOOL isSystemItem;

/**
 Additional target & action to do get callback action. Note that setting custom target & selector doesn't affect native functionality, this is just an additional target to get a callback.

 @param target Target object.
 @param action Target Selector.
 */
-(void)setTarget:(nullable id)target action:(nullable SEL)action;

/**
 Customized Invocation to be called when button is pressed. invocation is internally created using setTarget:action: method.
 */
@property (nullable, strong, nonatomic) NSInvocation *invocation;

@end
復(fù)制代碼

OC的注釋是通過/** */這樣的形式進(jìn)行編寫的。

分隔符使用的是這種風(fēng)格：

#pragma mark - 這個(gè)是一個(gè)分割符
復(fù)制代碼

需要注意的是這個(gè)-非常的重要，通過這個(gè)-，在查看代碼的時(shí)候，可以生成分隔線，讓代碼結(jié)構(gòu)看的更為清晰。

Swift的代碼注釋

隨著Swift語言發(fā)布，在Swift中編寫注釋的風(fēng)格就所有不同了：

extension NSObject {

    /// 對象獲取類的字符串名稱
    public var className: String {
        return runtimeType.className
    }

    /// 類獲取類的字符串名稱
    public static var className: String {
        return String(describing: self)
    }

    /// NSObject對象獲取類型
    public var runtimeType: NSObject.Type {
        return type(of: self)
    }

    /// 這是一個(gè)例子函數(shù)
    /// - Parameter arg:
    /// - Parameter argument: 傳入Int類型的參數(shù)
    /// - Returns: 返回Int類型的參數(shù)
    public func afunction(argument: Int) -> Int {
        return argument
    }
}

復(fù)制代碼

Swift的注釋是通過/// 這樣的形式進(jìn)行編寫的。

分隔符使用的是這種風(fēng)格：