pyargs

Python 함수에 대한 키워드 인수 생성

구문

kwa = pyargs(argKey,argValue)

설명

kwa = pyargs(argKey,argValue)는 Python^® 함수에 전달할 하나 이상의 키워드 인수를 만듭니다. Python 키워드 인수는 식별자가 앞에 오는 값입니다. pyargs를 최종 입력 인수로서 Python 함수에 배치합니다. 예를 들면 다음과 같습니다.

py.print('a','b',pyargs('sep',','))

pyargs로 만든 키워드 인수는 MATLAB^® dictionary 함수에 대한 키워드 인수로 전달하거나 keyMatch 함수에 대한 입력값으로 전달할 수 없습니다.

예제

키워드 인수를 사용하여 Python complex 함수 호출하기

Python complex 함수는 키워드 인수 real 및 imag를 갖습니다. 이 함수를 MATLAB에서 호출하는 경우 pyargs 함수나 name=value 구문을 사용하십시오. 두 호출 형식을 함께 사용하지 마십시오.

pyargs 인수를 사용하여 함수를 호출합니다.

py.complex(pyargs('real',1,'imag',2))

ans = 

  Python complex with properties:

    imag: 2
    real: 1

    (1+2j)

또는 name=value 구문을 사용하여 함수를 호출합니다.

py.complex(real=1,imag=2);

입력 인수

argKey,argValue — Python 함수 인수

키워드 및 값 인수

Python 함수 키워드 인수로, 하나 이상의 argKey,argValue 쌍의 인수가 쉼표로 구분되어 지정됩니다. argKey는 Python 함수 키 이름이며 string형 또는 문자형 벡터입니다. argValue는 인수 값이며 임의의 유효한 Python 유형으로 표현됩니다. argKey 및 argValue를 식별하려면 Python 함수 인수 목록을 사용합니다. argKey1,argValue1,...,argKeyN,argValueN과 같이 여러 개의 키 및 값 쌍의 인수를 어떤 순서로든 지정할 수 있습니다.

예: 'length',int32(2)

제한 사항

• 키워드 인수를 Python 함수로 전달할 때 pyargs 함수와 name=value 구문을 함께 사용하지 마십시오.

• MATLAB에서는 키워드 인수를 Python 함수로 전달하는 데 name,value 구문을 사용할 수 없습니다. 대신 name=value 구문을 사용하십시오.

대체 기능

MATLAB name=value 구문을 사용하여 Python 키워드 인수를 전달할 수 있습니다. 자세한 내용은 키워드 인수를 사용하여 Python complex 함수 호출하기 항목을 참조하십시오.

버전 내역

R2014b에 개발됨

R2022b: Python 키워드 인수 표시

pyargs 함수는 키워드(키-값 쌍) 인수를 표시합니다.

pyargs(A=1,B=2)

ans = 

  'pyargs' with pairs:

    A: 1
    B: 2

pyargs("A",1,"B",2)

ans = 

  'pyargs' with pairs:

    A: 1
    B: 2

R2021b: py. 접두사를 사용하여 Python 함수를 호출할 때 name=value 구문 오류 발생

R2021b에서 MATLAB은 py. 접두사를 사용하여 Python 함수로 키워드 인수를 전달할 때 name=value 구문을 사용하면 오류를 일으킵니다. R2021a에서 MATLAB은 오류를 표시하지 않고 잘못된 답을 제시하거나 Python 오류를 발생시킵니다. pyargs를 사용하여 키워드 인수를 전달하십시오.

예를 들어 Python print 함수는 키워드 인수 sep를 갖습니다. 다음 Python 명령문은 sep 인수를 쉼표 다음에 공백이 오는 값으로 설정합니다.

print('comma','separated','values',sep=', ')

MATLAB에서 이 명령문을 호출하면 MATLAB은 sep=', '를 name=value 인수로 해석합니다.

py.print('comma','separated','values',sep=', ')

R2021a 동작	R2021b 동작	코드를 업데이트하는 방법
py.print(... 'comma','separated','values',... sep=', ') 오류 표시 없이 잘못된 답: comma separated values sep ,	py.print(... 'comma','separated','values',... sep=', ') 오류: Error using py.print Using name=value format is not supported. Use pyargs to pass keyword arguments	py.print(... 'comma','separated','values',... pyargs(sep=', ')) comma, separated, values

참고 항목

도움말 항목

• MATLAB에서 Python 딕셔너리 사용하기
• Python 함수 인수 이해하기