ArgumentError

当函数传入了不可接受的参数时,会抛出错误。

方法应记录其接受的参数的限制,例如如果整数参数必须非空,字符串参数必须非空,或者动态类型的参数实际上应该有几种接受的类型之一。

用户应该能够预测哪些参数会导致抛出错误,并避免使用这些参数。

几乎总是有必要将不可接受的价值作为错误的一部分提供,以帮助用户找出哪里出错了,因此 ArgumentError.value 构造函数是首选构造函数。只有当某些原因无法提供值时,才应使用 ArgumentError.new

继承
实现者

构造函数

ArgumentError([dynamic message, @Since("2.14") String? name])
创建一个描述参数问题的错误 message
ArgumentError.notNull([String? name])
为必须非空的 null 参数创建一个参数错误。
ArgumentError.value(dynamic value, [String? name, dynamic message])
创建包含无效 value 的错误。

属性

hashCode int
此对象的哈希码。
no setterinherited
invalidValue → dynamic
无效的值。
final
message → dynamic
描述问题的消息。
final
name String?
如果可用,无效参数的名称。
final
runtimeTypeType
对象运行时类型的表示。
no setterinherited
stackTraceStackTrace?
此错误首次抛出时的堆栈跟踪。
no setterinherited

方法

noSuchMethod(Invocation invocation) → dynamic
当访问不存在的方法或属性时调用。
inherited
toString() String
此对象的字符串表示形式。
override

运算符

operator ==(Object other) bool
相等运算符。
inherited

静态方法

checkNotNull<@Since("2.8") T>(T? argument, [String? name]) → T
如果 argumentnull,将抛出异常。