"urllib.error" --- urllib.request 引發的例外類別
************************************************

**原始碼：**Lib/urllib/error.py

======================================================================

"urllib.error" module（模組）為 "urllib.request" 所引發的例外定義了例
外 (exception) 類別。基礎例外類別是 "URLError"。

下列例外會被 "urllib.error" 適時引發：

exception urllib.error.URLError

   處理程式 (handler) 在遇到問題時會引發此例外（或其衍生例外）。它是
   "OSError" 的一個子類別。

   reason

      此錯誤的原因。它可以是一個訊息字串或另一個例外實例。

   3.3 版更變: "URLError" 已被設為 "OSError" 而不是 "IOError" 的子類別
   。

exception urllib.error.HTTPError

   雖然是一個例外（"URLError" 的一個子類別），"HTTPError" 也可以作為一
   個非例外的類檔案回傳值（與 "urlopen()" 所回傳的物件相同）。這適用於
   處理特殊 HTTP 錯誤，例如為請求認證。

   code

      一個 HTTP 狀態碼，具體定義見 **RFC 2616**。這個數值會對應到存放
      在 "http.server.BaseHTTPRequestHandler.responses" 程式碼
      dictionary 中的某個值。

   reason

      這通常是一個解釋本次錯誤原因的字串。

   headers

      導致 "HTTPError" 的特定 HTTP 請求的 HTTP 回應 header。

      3.4 版新加入.

exception urllib.error.ContentTooShortError(msg, content)

   此例外會在 "urlretrieve()" 函式檢查到已下載的資料量小於期待的資料量
   （由 *Content-Length* header 給定）時被引發。"content" 屬性中將存放
   已下載（可能已被截斷）的資料。
