tango.core.Exception 翻译

￡神魔★判官ぃ 2022-05-03 05:26 153阅读 0赞

# **[tango.core.Exception][]（r4796)** #

The exception module defines all system-level exceptions and provides a mechanism to alter system-level error handling.

License:

BSD style: see [license.txt][]

Authors:

Sean Kelly, Kris Bell

class [OutOfMemoryException][] : Exception [¶][Link 1][\#][OutOfMemoryException]

抛出一个内存不足错误（ out of memory error）。

class [PlatformException][] : Exception [¶][Link 2][\#][PlatformException]

操作系统或库异常基类。

class [AssertException][] : Exception [¶][Link 3][\#][AssertException]

抛出一个断言错误。

class [ArrayBoundsException][] : Exception [¶][Link 4][\#][ArrayBoundsException]

抛出一个数组边界错误。

class [FinalizeException][] : Exception [¶][Link 5][\#][FinalizeException]

finalize（最终）错误时抛出。

class [SwitchException][] : Exception [¶][Link 6][\#][SwitchException]

switch错误时抛出。

class [TextException][] : Exception [¶][Link 7][\#][TextException]

表示一个文字处理错误。

class [UnicodeException][] : TextException [¶][Link 8][\#][UnicodeException]

unicode转换错误时抛出。

class [ThreadException][] : PlatformException [¶][Link 9][\#][ThreadException]

线程异常基类。

class [FiberException][] : ThreadException [¶][Link 10][\#][FiberException]

fiber 异常基类。

class [SyncException][] : PlatformException [¶][Link 11][\#][SyncException]

synchronization （同步）异常基类。

class [IOException][] : PlatformException [¶][Link 12][\#][IOException]

tango.io包抛出的基本异常。你应该确保所有和 IO相关的 Tango异常都从它派生。

class [VfsException][] : IOException [¶][Link 13][\#][VfsException]

tango.io.vfs 包抛出的基本异常。

class [ClusterException][] : IOException [¶][Link 14][\#][ClusterException]

tango.io.cluster包抛出的基本异常。

class [SocketException][] : IOException [¶][Link 15][\#][SocketException]

socket 异常基类。

class [HostException][] : IOException [¶][Link 16][\#][HostException]

被 InternetHost抛出的异常的基类。

class [AddressException][] : IOException [¶][Link 17][\#][AddressException]

被 Address （地址）抛出的异常的基类。

class [SocketAcceptException][] : SocketException [¶][Link 18][\#][SocketAcceptException]

当一个 socket（套接字）接受一个输入连接失败时抛出。

class [ProcessException][] : PlatformException [¶][Link 19][\#][ProcessException]

process （进程）错误时抛出。

class [RegexException][] : TextException [¶][Link 20][\#][RegexException]

regluar expression （正则表达式）异常基类。

class [LocaleException][] : TextException [¶][Link 21][\#][LocaleException]

locale （区域）异常基类。

class [XmlException][] : TextException [¶][Link 22][\#][XmlException]

XML 异常基类。

class [RegistryException][] : Exception [¶][Link 23][\#][RegistryException]

当网络注册（ NetworkRegistry）在代理注册期间遇到问题或看到一个未注册的 guid(全局统一标识符）时抛出 RegistryException（注册异常）异常。

class [IllegalArgumentException][] : Exception [¶][Link 24][\#][IllegalArgumentException]

遇到非法参数时抛出。

class [IllegalElementException][] : IllegalArgumentException [¶][Link 25][\#][IllegalElementException]

集合（ Collection ）方法如 add(或 replace)元素（和 /或 keys)时它们的参数是 null或不能传递筛选时抛出这个 IllegalElementException（非法参数异常）异常。

class [NoSuchElementException][] : Exception [¶][Link 26][\#][NoSuchElementException]

迭代器和容器的 past-the-end错误时抛出。（译注：如果迭代器到达了容器中的最后一个元素的后面，则迭代器变成 past-the-end值。使用一个 past-the-end值的指针来访问对象是非法的，就好像使用 NULL或未初始化的指针一样）

class [CorruptedIteratorException][] : NoSuchElementException [¶][Link 27][\#][CorruptedIteratorException]

检测到一个损坏的迭代器时抛出。

void [setAssertHandler][](assertHandlerType *h*) [¶][Link 28][\#][setAssertHandler]

用一个用户提供的断言处理器（ assert hander）覆盖（ Overrides）默认的版本时抛出该异常。

参数：

<table> 
 <tbody> 
  <tr> 
   <td> <p><span><em>h</em></span></p> </td> 
   <td> <p>新断言处理器。设置到<span>null</span>以使用默认的处理器。</p> </td> 
  </tr> 
 </tbody> 
</table>

void [onAssertError][](char\[\] *file*, size\_t *line*) \[extern(C)\] [¶][Link 29][\#][onAssertError]

在 D中断言错误的回调函数。如果已经提供，用户提供的断言处理器会被调用，否则会抛出 AssertException。

参数：

<table> 
 <tbody> 
  <tr> 
   <td> <p><span><em>file</em></span></p> </td> 
   <td> <p>向这个错误做出信号的文件名。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><span><em>line</em></span></p> </td> 
   <td> <p>这个错误发生的行号。</p> </td> 
  </tr> 
 </tbody> 
</table>

void [onAssertErrorMsg][](char\[\] *file*, size\_t *line*, char\[\] *msg*) \[extern(C)\] [¶][Link 30][\#][onAssertErrorMsg]

在 D中断言错误的回调函数。如果已经提供，用户提供的断言处理器会被调用，否则会抛出 AssertException。

参数：

void [onArrayBoundsError][](char\[\] *file*, size\_t *line*) \[extern(C)\] [¶][Link 31][\#][onArrayBoundsError]

在 D中数组边界错误的回调函数。 ArrayBoundsException （数组边界异常）会被抛出。

参数：

<table>     
 <tbody> 
  <tr> 
   <td> <p><span><em>file</em></span></p> </td> 
   <td> <p>向这个错误做出信号的文件名。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><span><em>line</em></span></p> </td> 
   <td> <p>这个错误发生的行号。</p> </td> 
  </tr> 
 </tbody> 
</table>

抛出：

ArrayBoundsException（数组边界异常）。

void [onFinalizeError][](ClassInfo *info*, Exception *ex*) \[extern(C)\] [¶][Link 32][\#][onFinalizeError]

在 D中 finalize 错误的回调函数。一个 FinalizeException 会被抛出。

参数：

<table> 
 <tbody> 
  <tr> 
   <td> <p><span><em>e</em></span></p> </td> 
   <td> <p>在<span>finalization </span>期间抛出的异常。</p> </td> 
  </tr> 
 </tbody> 
</table>

抛出：

FinalizeException.

void [onOutOfMemoryError][]() \[extern(C)\] [¶][Link 33][\#][onOutOfMemoryError]

在 D中内存溢出（内存不足）错误的回调函数。 OutOfMemoryException （内存溢出异常）会被抛出。

抛出：

OutOfMemoryException.

void [onSwitchError][](char\[\] *file*, size\_t *line*) \[extern(C)\] [¶][Link 34][\#][onSwitchError]

在 D中 switch错误的回调函数。一个 SwitchException 会被抛出。

参数：

抛出：

SwitchException.

void [onUnicodeError][](char\[\] *msg*, size\_t *idx*) \[extern(C)\] [¶][Link 35][\#][onUnicodeError]

D中 unicode错误的回调函数。一个 UnicodeException 会被抛出。

参数：

<table> 
 <tbody> 
  <tr> 
   <td> <p><span><em>msg</em></span></p> </td> 
   <td> <p>关于该错误的信息。</p> </td> 
  </tr> 
  <tr> 
   <td> <p><span><em>idx</em></span></p> </td> 
   <td> <p>这个错误被检测到的地方的字符串索引。</p> </td> 
  </tr> 
 </tbody> 
</table>

抛出：

UnicodeException.

[tango.core.Exception]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html
[license.txt]: http://www.dsource.org/projects/tango/wiki/LibraryLicense
[OutOfMemoryException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L61
[Link 1]: http://tango.dsource.org/docs/current/tango.core.Exception.html#OutOfMemoryException
[PlatformException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L78
[Link 2]: http://tango.dsource.org/docs/current/tango.core.Exception.html#PlatformException
[AssertException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L89
[Link 3]: http://tango.dsource.org/docs/current/tango.core.Exception.html#AssertException
[ArrayBoundsException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L106
[Link 4]: http://tango.dsource.org/docs/current/tango.core.Exception.html#ArrayBoundsException
[FinalizeException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L118
[Link 5]: http://tango.dsource.org/docs/current/tango.core.Exception.html#FinalizeException
[SwitchException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L138
[Link 6]: http://tango.dsource.org/docs/current/tango.core.Exception.html#SwitchException
[TextException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L150
[Link 7]: http://tango.dsource.org/docs/current/tango.core.Exception.html#TextException
[UnicodeException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L161
[Link 8]: http://tango.dsource.org/docs/current/tango.core.Exception.html#UnicodeException
[ThreadException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L176
[Link 9]: http://tango.dsource.org/docs/current/tango.core.Exception.html#ThreadException
[FiberException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L188
[Link 10]: http://tango.dsource.org/docs/current/tango.core.Exception.html#FiberException
[SyncException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L200
[Link 11]: http://tango.dsource.org/docs/current/tango.core.Exception.html#SyncException
[IOException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L214
[Link 12]: http://tango.dsource.org/docs/current/tango.core.Exception.html#IOException
[VfsException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L225
[Link 13]: http://tango.dsource.org/docs/current/tango.core.Exception.html#VfsException
[ClusterException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L236
[Link 14]: http://tango.dsource.org/docs/current/tango.core.Exception.html#ClusterException
[SocketException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L247
[Link 15]: http://tango.dsource.org/docs/current/tango.core.Exception.html#SocketException
[HostException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L261
[Link 16]: http://tango.dsource.org/docs/current/tango.core.Exception.html#HostException
[AddressException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L273
[Link 17]: http://tango.dsource.org/docs/current/tango.core.Exception.html#AddressException
[SocketAcceptException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L285
[Link 18]: http://tango.dsource.org/docs/current/tango.core.Exception.html#SocketAcceptException
[ProcessException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L297
[Link 19]: http://tango.dsource.org/docs/current/tango.core.Exception.html#ProcessException
[RegexException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L309
[Link 20]: http://tango.dsource.org/docs/current/tango.core.Exception.html#RegexException
[LocaleException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L321
[Link 21]: http://tango.dsource.org/docs/current/tango.core.Exception.html#LocaleException
[XmlException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L333
[Link 22]: http://tango.dsource.org/docs/current/tango.core.Exception.html#XmlException
[RegistryException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L347
[Link 23]: http://tango.dsource.org/docs/current/tango.core.Exception.html#RegistryException
[IllegalArgumentException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L359
[Link 24]: http://tango.dsource.org/docs/current/tango.core.Exception.html#IllegalArgumentException
[IllegalElementException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L375
[Link 25]: http://tango.dsource.org/docs/current/tango.core.Exception.html#IllegalElementException
[NoSuchElementException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L387
[Link 26]: http://tango.dsource.org/docs/current/tango.core.Exception.html#NoSuchElementException
[CorruptedIteratorException]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L399
[Link 27]: http://tango.dsource.org/docs/current/tango.core.Exception.html#CorruptedIteratorException
[setAssertHandler]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L419
[Link 28]: http://tango.dsource.org/docs/current/tango.core.Exception.html#setAssertHandler
[onAssertError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L439
[Link 29]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onAssertError
[onAssertErrorMsg]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L457
[Link 30]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onAssertErrorMsg
[onArrayBoundsError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L481
[Link 31]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onArrayBoundsError
[onFinalizeError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L496
[Link 32]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onFinalizeError
[onOutOfMemoryError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L509
[Link 33]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onOutOfMemoryError
[onSwitchError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L527
[Link 34]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onSwitchError
[onUnicodeError]: http://tango.dsource.org/docs/current/htmlsrc/tango.core.Exception.html#L543
[Link 35]: http://tango.dsource.org/docs/current/tango.core.Exception.html#onUnicodeError
[dil]: http://code.google.com/p/dil
[kandil]: http://code.google.com/p/dil/wiki/Kandil