mustBeText

R2026a

값이 string형 배열, 문자형 벡터, 또는 문자형 벡터로 구성된 셀형 배열인지 확인

구문

mustBeText(value)

설명

value가 string형 배열, 문자형 벡터, 또는 문자형 벡터로 구성된 셀형 배열이 아닌 경우 mustBeText(value)는 오류를 발생시킵니다. 빈 0x0 문자형 배열 '', 빈 string형 "", 누락값인 string형은 텍스트로도 간주되는 특별한 경우입니다. 이 함수는 값을 반환하지 않습니다.

예제

모두 축소

입력값이 텍스트인지 확인하기

숫자로 구성된 배열 notText를 만든 다음 mustBeText를 사용하여 값의 유효성을 검사합니다. 배열에 텍스트가 포함되어 있지 않으므로 mustBeText가 오류를 발생시킵니다.

notText = [1 2 3];
mustBeText(notText)

Value must be a character vector, string array, or cell array of character vectors.

인수 값 제한하기

mustBeText를 사용하여 함수가 받는 입력 인수 값을 제한합니다. 입력 인수의 유효성을 검사하는 함수에 arguments 블록을 추가하여 이를 수행할 수 있습니다.

이 함수는 인수 textInput의 값을 텍스트 값으로 제한합니다.

function MyFunction(textInput)
   arguments
      textInput {mustBeText}
   end
end

숫자형 입력 인수를 사용하여 함수를 호출합니다. MATLAB^®은 인수에 할당할 값에 대해 mustBeText를 호출합니다. 값 2가 텍스트가 아니므로 mustBeText는 오류를 발생시킵니다.

MyFunction(2)

Error using MyFunction (line 3)
 MyFunction(2)
            ^
Invalid argument at position 1. Value must be a character vector, string array, or cell array of character vectors.

입력 인수

모두 축소

`value` — 유효성을 검사할 값
스칼라 | 배열

유효성을 검사할 값으로, 스칼라 또는 배열로 지정됩니다. value가 string형 스칼라 또는 배열, 문자형 배열, 또는 문자형 벡터로 구성된 셀형 배열이 아닌 경우 mustBeText는 오류를 발생시킵니다.

예: mustBeText('foo')

확장 기능

모두 확장

C/C++ 코드 생성
MATLAB® Coder™를 사용하여 C 코드나 C++ 코드를 생성할 수 있습니다.

GPU 코드 생성
GPU Coder™를 사용하여 NVIDIA® GPU용 CUDA® 코드를 생성할 수 있습니다.

버전 내역

R2020b에 개발됨

참고 항목

mustBeTextScalar | mustBeNonzeroLengthText | arguments