本页采用了机器翻译。点击此处可查看英文原文。

validateLengthUnit

验证并标准化长度单位

全页折叠

语法

standardName = validateLengthUnit(unit)
standardName = validateLengthUnit(unit,funcName,varName,argIndex)

说明

standardName = validateLengthUnit(unit) 会检查 unit 是否为有效的长度单位，并将其转换为标准单位名称。该函数对输入不区分大小写。空格、句号和撇号将被忽略。在大多数情况下，复数形式也是被接受的，但结果 standardName 始终是单数形式。

示例

standardName = validateLengthUnit(unit,funcName,varName,argIndex) 会检查 unit 是否为有效的长度单位；如果不是，则使用选项 funcName、varName 和 argIndex 生成错误消息，其行为与同名的 validateattributes 输入提供的行为完全一致。

示例

示例

全部折叠

打开实时脚本

当输入其他适用于 'foot' 的有效字符串时，找出适用于 'foot' 的有效长度单位名称。

validateLengthUnit('foot')
ans = 
'foot'

validateLengthUnit('feet')
ans = 
'foot'

validateLengthUnit('international feet')
ans = 
'foot'

当输入其他适用于 'kilometer' 的有效字符串时，找出适用于 'kilometer' 的有效长度单位名称。 

validateLengthUnit('kilometer')
ans = 
'kilometer'

validateLengthUnit('km')
ans = 
'kilometer'

validateLengthUnit('kilometre')
ans = 
'kilometer'

validateLengthUnit('kilometers')
ans = 
'kilometer'

validateLengthUnit('kilometres')
ans = 
'kilometer'

当名称中包含撇号时，查找有效的长度单位名称。

validateLengthUnit('Clarke''s foot')
ans = 
'Clarke's foot'

使用 validateLengthUnit 函数创建自定义错误消息。向 validateLengthUnit 提供无效输入时，会显示一条错误消息，其中提到了函数名 'FOO'、变量名 'UNIT' 以及参量编号 5。

validateLengthUnit(17,'FOO','UNIT',5)

Error using FOO
Expected input number 5, UNIT, to be one of these types:

char, string

Instead its type was double.

Error in validateLengthUnit (line 87)
validateattributes(unit,{'char','string'},{'nonempty','scalartext'},varargin{:})

输入参数

全部折叠

长度单位，可指定为以下任意一种：

值单位名称
"m", "meter", "meters", "metre", "metres"米
"cm", "centimeter", "centimeters", "centimetre", "centimetres"厘米
"mm", "millimeter", "millimeters", "millimetre", "millimetres"毫米
"micron", "microns"微米
"km", "kilometer", "kilometers", "kilometre", "kilometers"公里
"nm", "naut mi", "nautical mile", "nautical miles"海里
"ft", "international ft", "foot", "international foot", "feet", "international feet"英尺
"in", "inch", "inches"英寸
"yd", "yds", "yard", "yards"码
"mi", "mile", "miles", "international mile", "international miles"英里
"sf", "survey ft", "US survey ft", "U.S. survey ft", "survey foot", "US survey foot", "U.S. survey foot", "survey feet", "US survey feet", "U.S. survey feet"美国测量英尺
"sm", "survey mile", "survey miles", "statute mile", "statute miles", "US survey mile", "US survey miles", "U.S. survey mile(s)", "U.S. survey miles"美国测量英里（法定英里）
"Clarke's foot", "Clarkes foot"克拉克英尺
"German legal metre", "German legal meter"德国法定米制
"Indian foot"印度英尺

示例: validateLengthUnit("feet")

数据类型: char | string

要验证其输入的函数名称，指定为字符串标量或字符向量。如果指定空字符串或字符向量 ('')，则 validateLengthUnit 函数会忽略 funcName 的值。

示例: validateLengthUnit(17,'FOO','UNIT',5)

数据类型: char | string

输入变量的名称，指定为字符串标量或字符向量。如果指定空字符串或字符向量 ('')，则 validateLengthUnit 函数会忽略 varName 的值。

示例: validateLengthUnit(17,'FOO','UNIT',5)

数据类型: char | string

输入参量的位置，以正整数形式指定。

示例: validateLengthUnit(17,'FOO','UNIT',5)

数据类型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

输出参量

全部折叠

标准长度单位的名称，以字符向量形式返回。

版本历史记录

在 R2006a 之前推出

另请参阅