zoukankan      html  css  js  c++  java
  • 代码注释

    1、#pragma mark

    #pragma mark -
    #pragma mark Table Delegate Methods

    从技术上讲,以 #pragma 开头的代码是一条编译器指令,是一个特定于程序或编译器的指令。它们不一定适用于其它编译器或其它环境。如果编译器不能识别该指令,则会将其忽略。

    作用: 

    告诉Xcode编译器,要在编辑器窗格顶部的方法和函数弹出菜单中将代码分隔开,如下图所示:

     

    2、属性注释

    @property(nonatomic, copy)NSString* trackerId;/**< 即appid 标识 */

    即在别处该属性值上按下option键,单击即可查看注释

     

    3、方法注释

    /** 自定义事件,时长统计.

        使用前,请先到友盟App管理后台的设置->编辑自定义事件 中添加相应的事件ID,然后在工程中传入相应的事件ID.

        beginEvent,endEvent要配对使用,也可以自己计时后通过durations参数传递进来

     @param  eventId 网站上注册的事件Id.

     @param  label 分类标签。不同的标签会分别进行统计,方便同一事件的不同标签的对比,为nil或空字符串时后台会生成和eventId同名的标签.

     @param  primarykey 这个参数用于和event_id一起标示一个唯一事件,并不会被统计;对于同一个事件在beginEvent和endEvent 中要传递相同的eventId 和 primarykey

     @param millisecond 自己计时需要的话需要传毫秒进来

     @return void. 

     @warning 每个event的attributes不能超过10个

        eventId、attributes中key和value都不能使用空格和特殊字符,且长度不能超过255个字符(否则将截取前255个字符)

        id, ts, du是保留字段,不能作为eventId及key的名称

    @noto 注意!!!!!

    */

    + (void)beginEvent:(NSString *)eventId;

    同样按下option键,单击即可查看注释

     

    4、特殊注释:

    // TODO:
    // FIXME:
    // !!!:
    // ???:

    在Targets的Build Phases点击 左上角+选择Run Script,输入

    KEYWORDS="TODO:|FIXME:|???:|!!!:"

    find "${SRCROOT}" ( −name "*.h" −or −name "*.m" ) -print0 | xargs

    -0 egrep --with-filename --line-number --only-matching

    "($KEYWORDS).*$" | perl -p -e "s/($KEYWORDS)/ warning: $1/"

    此时即可在Warning列表中看到注释(会有错误警告,还未找到方法)

    还会这样

    5、类简介

    /*! @brief 微信通知第三方程序,要求第三方程序显示或处理某些消息,第三方程序处理完后向微信终端发送的处理结果。

     *

     * 微信需要通知第三方程序显示或处理某些内容时,会向第三方程序发送ShowMessageFromWXReq消息结构体。

     * 第三方程序处理完内容后调用sendResp向微信终端发送ShowMessageFromWXResp。

     */

    @interface ShowMessageFromWXResp : BaseRes

  • 相关阅读:
    Duilib 源码分析(二)消息处理
    Duilib 源码分析(一)示例推演
    2021 Duilib最新入门教程(七)Duilib处理消息
    2021 Duilib最新入门教程(六)Duilib界面设计
    2021 Duilib最新入门教程(五)Duilib调用静态库示例
    2021 Duilib最新入门教程(四)Duilib编译静态库
    源文件(cpp)、静态库(lib)、动态库(dll)
    2021 Duilib最新入门教程(三)Duilib调用动态库示例
    supernova-SN_TV MUF简介
    jieba+pyecharts 词云图应用
  • 原文地址:https://www.cnblogs.com/swallow37/p/4977103.html
Copyright © 2011-2022 走看看