Exponenta Banner
exponenta event banner

validateLengthUnit

Проверка и стандартизация единиц измерения длины

свернуть все на странице

Синтаксис

standardName = validateLengthUnit (единица измерения)
standardName = validateLengthUnit (единица измерения, 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{:})

Входные аргументы

свернуть все

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

Наименование единицыЗначения
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)',
'international mile(s)'
U.S. survey foot'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'
U.S. survey mile (statute mile)'sm', 'survey mile(s)',
'statute mile(s)',
'US survey mile(s)',
'U.S. survey mile(s)'
Clarke's foot'Clarke's foot', 'Clarkes foot'
German legal metre'German legal metre',
'German legal meter'
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

Документация по панели инструментов сопоставления

Поддержка