•  生日

  •  時鐘


  •  搜尋
  • 進階搜尋



  •  最新的會員

  •  連結我們
  • 請使用底下的 HTML 語法,隨意放置 E-Office學園 之連結:



  • 歡迎訊息
最新消息: 目前Eoffice已經能支援使用手持裝置瀏覽,自動導入手機版網頁,歡迎測試回報!


  • 全域公告

檢視最後發表 [教學]一乙從現在開始所有程式都要寫註解


一乙從現在開始所有程式都要寫註解

1.請寫班級、學號、姓名

2.程式的摘要 (題目)

3.變數名稱命名要有意義 (或利用註解釋變數的使用目的),變數名稱亂取的也會被扣分

4.請解釋if或for、while的用途,方法的作用等,不寫註解或亂寫註解的會被扣分



還有程式要縮排,沒有縮排或亂縮排的也會被扣分

程式無法編譯一律不給分



機測也會照此標準扣分



相關討論:

http://eoffice.im.fju.edu.tw/phpbb/viewtopic.php?t=3826



如果你看了XO老師提供的文件,你就會有一些想法,以MIT的那一份為例 (我把它簡要的翻譯一下)

1.讓讀者可以少讀程式碼,當程式裡有一些公式時,可以利用註解讓讀者了解公式的用義 (如:計算變異數),或參數及回傳值的意義

// compute the standard deviation of list elements that are

// less than the cutoff value

for (int i=0; i<n; i++) {

//...

}



2.解釋一些難以了解的步驟或邏輯,尤其是有些步驟的影響是不能直接看到的

// Signal that a new transfer request is complete and ready

// to process. The manager thread will begin the disk transfer

// the next time it wakes up and notices that this variable has changed.

buffer_manager.active_requests ++;



3.記錄程式的假設

// The buffer contains at lea [...]

觀看: 8822  •  評語: 5  •  發表回覆 [ 閱讀全部 ]


  • 最新消息
    回覆
    觀看
    最後發表

  • 誰在線上?
  • 線上共有 17 位使用者:1 位註冊會員、0 位隱形會員和 16 位訪客 (這些資料是根據過去 5 分鐘內使用者的活動記錄)
    最高線上人數記錄為 523 人 [ 記錄時間:週日 7月 01, 2012 1:19 pm ]

    註冊會員: Bing [Bot]
    顏色說明: 管理員, 全域版主





  •  統計資料
  • 全部的
    文章總數:33270
    主題總數:7128
    全部的公告: 34
    全部的置頂: 60
    全部的附加檔案: 7332

    每天發表的主題數:1
    每天發表的文章數:6
    每天註冊的會員數:1
    每個會員的主題數:2
    每個會員的文章數:9
    每個主題的文章數:5

    會員總數:3572
    最新註冊的會員:SabinaAdolph

  •  行事曆
  • << 3月. 2019 >>
    1 2
    3 4 5 6 7 8 9
    10 11 12 13 14 15 16
    17 18 19 20 21 22 23
    24 25 26 27 28 29 30
    31


  •  最近的機器人
  • Bing [Bot]
    週五 3月 22, 2019 4:53 pm