MATLAB 程式設計 程式除錯 方煒 台大生機系

一般除錯技巧(1) 一般偵測邏輯錯誤的方法： 去除運算式最尾端的分號，運算式執行的結果會印在 MATLAB 指令視窗中。 在程式中加入 keyboard 指令，可使程式執行至此處即暫停，並顯示“k >”的提示號（k 代表 keyboard），以便查看或改變工作空間的任何變數，若要繼續執行程式，可在 MATLAB 指令視窗下輸入“return”並按下 Enter 鍵。

一般除錯技巧(2) 使用判斷式及 fprintf 指令印出變數的值。 在除錯一個單獨函數時，可在其第一列的函數宣告列加上 %，並定義輸入引數的值，此時我們就可以直接以腳本（Scripts）的方式來執行此 M 檔案，並保留所有變數於 MATLAB 工作空間之中。 使用 MATLAB 除錯程式。

MATLAB 的除錯器 除錯器(debugger)功能包含： 查詢每一個函數的工作空間（Workspace） 顯示函數呼叫過程中的的堆疊（Function Call Stack） 一列一列地執行 M 檔案（Step-by-step Execution）

MATLAB 的除錯器 以命令列為主的程式除錯 以圖形介面進行程式除錯

以命令列為主的程式除錯(1) 語 法 功 能 dbstop at line# in filename 設定中斷點（Break Points） 語 法 功 能 dbstop at line# in filename 設定中斷點（Break Points） （line# 代表行號，filename 代表檔案名稱） dbclear at line# in filename 清除中斷點 （line#代表行號，filename 代表檔案名稱） dbstop if warning dbstop if error dbstop if naninf dbstop if infnan 若遇到「警告」（Warning）、「錯誤」（Error）、或「非數值/無窮大」（NaN/Inf），則暫停程式執行

以命令列為主的程式除錯(2) dbcont 從暫停狀態繼續執行 dbstackdbstatus filename 列出某檔案的所有中斷點 dbstep n 執行 n 列指令 dbtype filename 列出檔案內容（包含每列編號） dbdown 向下進入局部的工作空間 dbup 向上進入呼叫端的工作空間 dbquit 離開除錯模式

dbstop 的一般格式及相關說明 可以利用dbstop來指定程式碼的中斷點 指 令 格 式 說 明 指 令 格 式 說 明 dbstop in filename at line# 停止執行於某檔案的某行 dbstop in filename at subfunction 停止執行於某檔案的次函數 dbstop in filename 停止執行於某檔案 dbstop if error 若出現錯誤，則暫停程式執行，並停留在發生錯誤的工作空間 dbstop if warning 若出現警告，則暫停程式執行，並停留在發生警告的工作空間 dbstop if naninf dbstop if infnan 若出現 nan 或 inf，則暫停程式執行，並停留在發生 nan 或 inf的工作空間

進入除錯模式後的動作 檢查任何變數的值，也可以執行其他任何指令或手稿(script)。 檢查完畢後，可能採取的動作有： 指 令 格 式 指 令 格 式 說 明 dbcont 繼續執行程式 dbstep n 執行 n 列程式碼 dbtype filename 列出程式碼 dbdown 向下切換至另一個工作空間 dbup 向上切換至另一個工作空間 dbstack 列出函數呼叫過程中的堆疊 dbquit 跳出除錯模式

dbstep 的格式及說明 dbstep可以一次執行一列或多列程式碼，或是進入或跳出一個指令的內部程式碼 。 指 令 格 式 說 明 指 令 格 式 說 明 dbstep 執行下一列程式碼 dbstep n 執行下 n 列程式碼 dbstep in 進入下一列指令的程式碼 dbstep out 跳出目前指令的程式碼

dbclear及dbstatus 的用法 dbclear 用於取消中斷點，用法與dbstop的格式同，只需將dbstop改成dbclear。若要清除所有的中斷點，可用 dbclear all。 dbstatus 可列出所有的中斷點。 指 令 格 式 說 明 dbstatus 列出所有中斷點 dbstatus filename 列出在一檔案中的中斷點 s = dbstatus(…) 將中斷點的資訊傳回變數 s

範例：計算一向量的倒數和 範例： recipsum.m 此函數包含一錯誤，執行時即會出現： >> type recipsum function out = recipsum(x) recip = reciproc(x); out = sum(recip); function output = reciproc(input) output = 1./x; >> recipsum([1 2 3]) ??? Input argument 'x' is undefined. Error in ==> D:\matlabBook\MATLAB程式設計\程式除錯\recipsum.m On line 3 ==> recip = reciproc(x);

使用dbstop及dbstatus 讓MATLAB 停留在產生錯誤訊息的函數： >> dbstop if error 確認所建的中斷條件： 　　 >> dbstatus 　　　　　　　　　　　　　　 Stop if error. 再呼叫原函數，會停在錯誤發生的程式碼：

使用dbstack及dbtype 此時可在指令視窗使用 dbstack 來顯示 MATLAB 所在的函數： k>> dbstack >In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum.m (reciproc) at line 7 In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum.m at line 3 k>> dbtype 1 function out = recipsum(x) 2 3 recip = reciproc(x); 4 out = sum(recip); 5 6 function output = reciproc(input) 7 output = 1./x;

使用dbquit、dbup及dbdown 在除錯器中將x改成input，則正確答案為： 當程式暫停執行於一個函數時，可以使用 dbup 及 dbdown 來跳到不同的工作空間，以便檢視各變數。 k>> dbquit % 離開除錯模式 >> recipsum1([1 2 3]) ans = 1.8333

設立中斷條件 上述範例修正後的檔案為recipsum1.m，執行時還是可能會有問題 => Divide by zero. 另設一個中斷條件來檢查錯誤所在，再呼叫函數： >> recipsum1([2 0 2]) Warning: Divide by zero. >In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum1.m (reciproc) at line 7 In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum1.m at line 3 ans = Inf >> dbstop if naninf >> recipsum1([2 0 2]) Warning: Divide by zero. >In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum1.m (reciproc) at line 7 In D:\matlabBook\MATLAB程式設計\程式除錯\recipsum1.m at line 3

除錯後的最終結果 假設在輸入為 0 時，其倒數不計，則程式碼可修正如下，recipsum2.m： 正確答案為： k>> dbquit % 離開除錯模式 >> type recipsum2 function out = recipsum(x) recip = reciproc(x); out = sum(recip); function output = reciproc(input) input(find(input==0)) = []; % Eliminate "0" elements output = 1./input; >> recipsum2([2 0 2]) ans = 1

以圖形介面進行程式除錯 由指令列下達 edit 指令，如： >> edit recipsum1 可開啟 MATLAB編輯器（也是除錯器）

除錯指令與圖示 圖 示 MATLAB 對應指令 說 明 dbstop/dbclear 設立或移除中斷點 dbclear all 圖 示 MATLAB 對應指令 說 明 dbstop/dbclear 設立或移除中斷點 dbclear all 移除所有中斷點 dbstep 執行下一列程式碼 dbstep in 進入某函數程式碼 dbstep out 退出某函數程式碼 dbcont 繼續執行程式碼 dbquit 跳出除錯模式 dbtype 列出程式碼

不同版本的MATLAB圖示對應關係 第六/七版 圖示 第五版 MATLAB 對應指令 說 明 dbstop/dbclear 設立或移除中斷點 說 明 dbstop/dbclear 設立或移除中斷點 dbclear all 移除所有中斷點 dbstep 執行下一列程式碼 dbstep in 進入某函數程式碼 無 dbstep out 退出某函數程式碼 dbcont 繼續執行程式碼 dbquit 跳出除錯模式 dbtype 列出程式碼

設立中斷點(1) 欲設立中斷點於 reciproc 函數的第一列，可利用滑鼠將游標置於該列並點取 圖示。(紅點代表中斷點 )

設立中斷點(2) 若執行此函數，即可停於該中斷點： >> recipsum1([1 2 3]) (綠色箭號顯示現在所在的位置 )

檢視變數或運算式 中斷後可在指令列檢視各個變數的值，或選取工具列上的 stack 下拉式選單，可切換至不同的工作空間。 檢視變數或運算式： 在Command Window指令列輸入變數或運算式。 選取變數或運算式後，利用滑鼠右鍵點取，並選擇“Evaluate Selection”。Matlab 會去執行該列，並顯示結果。

逐步執行 若按下 圖示（或在指令列輸入 dbstep），則綠色箭號變成向下，代表即將離開此次函數。

End of Debugging