Exponenta Banner
exponenta event banner

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 тех же имен.

Примеры

свернуть все

Скрипт Open Live Script

Найдите допустимое имя единицы длины для '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{:})

Входные параметры

свернуть все

Единица длины, заданная как любое следующее:

Модульное имяЗначения
meter'm', 'meter(s)', 'metre(s)'
centimeter'cm', 'centimeter(s)', 'centimetre(s)'
millimeter'mm', 'millimeter(s)', 'millimetre(s)'
micron'micron(s)'
kilometer'km', 'kilometer(s)', 'kilometre(s)'
nautical mile'nm', 'naut mi', 'nautical mile(s)'
foot'ft', 'international ft',
'foot', 'international foot',
'feet', 'international feet'
inch'in', 'inch', 'inches'
yard'yd', 'yds', 'yard(s)'
mile'ми', 'миля (мили)',
'международная миля (мили)'
U.S. survey foot'sf',
'рассмотрите ft', 'США рассматривают ft',
'США рассматривают ft', 'рассматривают ногу',
'США рассматривают ногу',
'США рассматривают ногу',
'рассмотрите ноги', 'США рассматривают ноги',
'США рассматривают ноги'
U.S. survey mile (statute mile)'см', 'миля (мили) обзора',
'статутная миля (мили)',
'США рассматривают милю (мили)',
'США рассматривают милю (мили)'
Clarke's foot'Clarke's foot', 'Clarkes foot'
German legal metre'Немецкий легальный метр',
'Немецкий легальный метр'
Indian foot'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

Документация Mapping Toolbox
Поддержка