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 допустимая единица длины и, если это не, создает сообщение об ошибке с помощью дополнительных входных параметров funcNamevarName , и 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
Поддержка