coder.PrimitiveType 클래스

네임스페이스: coder
슈퍼클래스: coder.ArrayType

입력 사양에 허용되는 논리형 배열, 숫자형 배열 또는 문자형 배열 집합 표현

설명

coder.PrimitiveType의 객체는 생성 코드에서 허용하는 논리형 값, 숫자형 값 또는 문자형 값을 지정합니다. 지원되는 유형은 half, double, single, int8, uint8, int16, uint16, int32, uint32, int64, uint64, char, logical입니다. 이 클래스의 객체는 fiaccel 명령의 -args 옵션에만 사용하십시오. 생성된 MEX 함수에 대한 입력값으로 전달하지 마십시오.

생성

t = coder.typeof(v)는 v를 포함하는 가장 작은 상수가 아닌 유형을 나타내는 coder.PrimitiveType 객체를 생성합니다. v는 MATLAB^® 숫자형, 논리형 또는 문자형이어야 합니다.

t = coder.typeof(v,sz,variableDims)는 sz로 지정된 상한 크기와 variableDims로 지정된 가변 차원을 갖는 coder.PrimitiveType 객체를 생성합니다. sz가 차원에 대해 Inf를 지정할 경우 차원의 크기는 비유계 가변 크기가 됩니다. sz가 []이면 v의 상한 크기는 변경되지 않은 상태로 유지됩니다. variableDims를 지정하지 않으면 해당 유형의 유계 차원이 고정됩니다. variableDims가 스칼라이면 이 함수는 이 값을 1 또는 0인 차원(고정 크기)이 아닌 유계 차원에 적용합니다.

t = coder.newtype(numericClass,sz,variableDims)는 sz로 지정된 상한 크기와 variableDims로 지정된 가변 차원을 갖는 numericClass 클래스의 값을 나타내는 coder.PrimitiveType 객체를 생성합니다. sz가 차원에 대해 Inf를 지정할 경우 차원의 크기는 비유계 가변 크기가 됩니다. variableDims를 지정하지 않으면 해당 유형의 유계 차원이 고정됩니다. variableDims가 스칼라이면 이 함수는 이 값을 1 또는 0인 차원(고정 크기)이 아닌 유계 차원에 적용합니다.

t = coder.newtype(numericClass,sz,variableDims,Name=Value)는 하나 이상의 이름-값 인수로 지정된 추가 옵션을 사용하여 coder.PrimitiveType 객체를 생성합니다. Name은 속성 이름이고 Value는 해당하는 값입니다. Name을 문자형 벡터 또는 string형 스칼라로 지정하십시오. Name1=Value1,…,NameN=ValueN과 같이 여러 개의 이름-값 쌍 인수를 어떤 순서로든 지정할 수 있습니다.

참고

코더 유형 편집기를 사용하여 대화형 방식으로 coder.Type 객체를 생성하고 편집할 수 있습니다. Create and Edit Input Types by Using the Coder Type Editor 항목을 참조하십시오.

입력 인수

v — 입력 변수

숫자형 | 논리형 | 문자형

입력 변수로, 숫자형 값, 논리형 값 또는 문자형 값으로 지정됩니다.

sz — type 객체 차원의 크기

정수형 벡터

type 객체 차원의 크기로, 정수로 구성된 벡터로 지정됩니다.

variableDims — 가변 크기를 지정하는 옵션

부울 벡터

각 차원이 가변 크기인지 여부를 지정하는 옵션으로, 부울 벡터로 지정됩니다. 이 벡터의 요소를 1로 지정하면 대응하는 차원이 가변 크기를 갖습니다. 그 외의 경우에는 차원이 고정 크기입니다.

numericClass — 원시 클래스 유형

string형 스칼라 | 문자형 벡터

원시 클래스 유형으로, string형 스칼라 또는 문자형 벡터로 지정됩니다.

이름-값 인수

선택적 인수 쌍을 Name1=Value1,...,NameN=ValueN으로 지정합니다. 여기서 Name은 인수 이름이고 Value는 대응값입니다. 이름-값 인수는 다른 인수 뒤에 와야 하지만, 인수 쌍의 순서는 상관없습니다.

R2021a 이전 릴리스에서는 쉼표를 사용하여 각 이름과 값을 구분하고 Name을 따옴표로 묶으십시오.

complex — 복소수 값을 나타내는 옵션

false 또는 0 (디폴트 값) | true 또는 1

복소수 값을 나타낼 수 있는 coder.PrimitiveType 객체를 생성하는 옵션으로, 숫자형 또는 논리형 1(true) 또는 0(false)으로 지정됩니다.

sparse — 희소 데이터를 나타내는 옵션

false 또는 0 | true 또는 1

희소 값을 나타낼 수 있는 coder.PrimitiveType 객체를 생성하는 옵션으로, 숫자형 또는 논리형 1(true) 또는 0(false)으로 지정됩니다.

gpu — GPU 데이터를 나타내는 옵션

false 또는 0 | true 또는 1

GPU 데이터 값을 나타낼 수 있는 coder.PrimitiveType 객체를 생성하는 옵션으로, 숫자형 또는 논리형 1(true) 또는 0(false)으로 지정됩니다.

속성

complex — 복소수 값을 나타내는 옵션

1 (디폴트 값) | 0

복소수 값을 나타내는 옵션으로, 0 또는 1로 지정됩니다. 유형이 복소수 데이터를 지원해야 합니다. 문자형 배열은 복소수 데이터를 지원하지 않습니다.

sparse — 희소 데이터를 나타내는 옵션

1 | 0

희소 데이터를 나타내는 옵션으로, 0 또는 1로 지정됩니다. 유형이 희소 데이터를 지원해야 합니다. 문자형과 반정밀도 데이터형은 희소 데이터를 지원하지 않습니다.

gpu — GPU 데이터를 나타내는 옵션

1 | 0

GPU 입력 유형을 나타내는 옵션으로, 0 또는 1로 지정됩니다. 이 옵션을 사용하려면 GPU Coder™ 라이선스가 필요합니다. 유형이 GPU 데이터를 지원해야 합니다. 문자형과 반정밀도 데이터형은 GPU 배열을 지원하지 않습니다.

예제

Primitive Type 객체 생성하기

coder.typeof를 사용하여 입력 변수, 차원, 가변 크기 플래그를 지정합니다.

z = coder.typeof(0,[2 3 4],[1 1 0]) 

z = 
coder.PrimitiveType
   :2×:3×4 double

    Edit Type Object

코드 생성에 Primitive Type 객체 사용하기

coder.PrimitiveType 객체를 생성합니다.

z = coder.typeof(0,[2 3 4],[1 1 0])

유형이 z인 입력 파라미터를 한 개 갖는 MATLAB 함수에 대한 C 라이브러리를 생성합니다.

codegen -config:lib fcn -args {z}

버전 내역

R2011a에 개발됨

참고 항목

coder.ClassType (MATLAB Coder) | coder.Type | coder.ArrayType | coder.newtype | coder.typeof | coder.resize | fiaccel

도움말 항목

• Create and Edit Input Types by Using the Coder Type Editor