convlength

Convert from length units to desired length units

Syntax

convertedValues = convlength(valuesToConvert,inputLengthUnits,outputLengthUnits)

Description

convertedValues = convlength(valuesToConvert,inputLengthUnits,outputLengthUnits) converts valuesToConvert from original units to desired units using computed conversion factor.

Examples

Convert Lengths

Convert three lengths from feet to meters.

a = convlength([3 10 20],'ft','m')

a = 1×3

    0.9144    3.0480    6.0960

Input Arguments

valuesToConvert — Input lengths to convert

floating-point array of m-by-n values

Input lengths to convert, specified as a floating-point array of m-by-n values, in original units. All values must have the same units.

Data Types: double

inputLengthUnits — Original unit

'ft' | 'm' | 'km' | 'in' | 'naut mi'

Original unit of input lengths, specified as:

'ft'	Feet
'm'	Meters
'km'	Kilometers
'in'	Inches
'mi'	Miles
'naut mi'	Nautical miles

Data Types: char | string

outputLengthUnits — Units to convert to

'ft' | 'm' | 'km' | 'in' | 'naut mi'

New unit to convert to, specified as:

'ft'	Feet
'm'	Meters
'km'	Kilometers
'in'	Inches
'mi'	Miles
'naut mi'	Nautical miles

Data Types: char | string

Output Arguments

convertedValues — Converted lengths

floating-point array of size m-by-n values

Converted lengths, returned in new units.

Version History

Introduced in R2006b