Exponenta 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 входы с одинаковыми именами.

Примеры

свернуть все

Открыть 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'mi', 'mile (s )',
'внутренняя миля (и)'
U.S. survey foot'sf',
'рассмотрите ft', 'США рассматривают ft',
'Обследование США ft', 'обследование ног',
«Освидетельствование ног в США»,
«Освидетельствование ног в США»,
'survey feet', 'USA survey feet',
The U.S. survey feet
U.S. survey mile (statute mile)sm ',' survey mile (s) ',
'statute mile (s )',
«Обзорная миля (мили) США »,
«Разведочная миля (мили) в США»
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

Поддержка