mustBeTextScalar

값이 한 조각의 텍스트인지 확인

R2020b 이후

구문

mustBeTextScalar(value)

mustBeTextScalar(value)는 value가 텍스트 스칼라가 아닌 경우 오류를 발생시킵니다. 텍스트 스칼라는 한 조각의 텍스트이지만, 데이터형에 따라 정의가 다릅니다.

string형 배열의 경우, 한 조각의 텍스트는 1×1 스칼라(예: “text”)입니다. 빈 string형 ""과 누락값인 string형은 한 조각의 텍스트로 간주되는 특수한 경우입니다.
문자형 배열의 경우, 한 조각의 텍스트는 행 벡터(예: ‘text’)입니다. 빈 0×0 문자형 배열 ''은 한 조각의 텍스트로 간주되는 특수한 경우입니다.

이 함수는 값을 반환하지 않습니다.

string형으로 구성된 배열 text를 만든 다음 mustBeTextScalar를 사용하여 값의 유효성을 검사합니다. 변수에 string형이 여러 개 포함되어 있으므로 mustBeTextScalar가 오류를 발생시킵니다.

text = ["this" "will" "throw" "an" "error"];
mustBeTextScalar(text)

Value must be a character vector or string scalar.

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

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

function MyFunction(textScalarInput)
   arguments
      textScalarInput {mustBeTextScalar}
   end
end

함수를 호출합니다. MATLAB^®은 인수에 할당할 값에 대해 mustBeTextScalar를 호출합니다. 값 ["foo","bar"]가 텍스트 스칼라가 아니므로 mustBeTextScalar는 오류를 발생시킵니다.

MyFunction(["foo","bar"])

Error using MyFunction
 MyFunction(["foo","bar"]);
            ↑
Invalid argument at position 1. Value must be a character vector or string scalar.

유효성을 검사할 값으로, 스칼라 또는 배열로 지정됩니다. value가 1x1 string형 배열, "" 또는 <missing> string형, 행 벡터 문자형 배열 또는 ''인 경우 mustBeTextScalar는 오류를 발생시킵니다.

예: mustBeTextScalar('foo')

R2020b에 개발됨