APIAny_UsableGDLStringID

문자열이 GDL 키워드인지, 예약된 심볼인지 여부를 결정합니다.

    GSErrCode ACAPI_Goodies (
        APIAny_UsableGDLStringID,
        const char*     str
    );

 

파라미터

str

[in] GDL 키워드인지 예약된 심볼인지 여부를 확인할 문자열입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

str이 NULL입니다.

APIERR_GENERAL

문자열이 유효한 GDL 키워드 또는 예약된 심볼입니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 주어진 문자열이 예약된 GDl 키워드 또는 심볼인지 여부를 확인하는 데 사용합니다; 또는 그것이 되기 위해 특정 요구사항들을 충족하는지 여부를 확인하는 데에도 사용합니다.

만약 전달된 문자열이 GDL 스크립트에서 고유 식별자로 사용될 수 있으면 일반적으로 이 함수는 NoError를 리턴합니다. 예를 들어, 스크립트들이 설치된 라이브러리 파트를 생성하고 스크립트 중 일부가 즉시 만들어지는 경우, 가용성에 대하여 구성요소들을 확인하는 것이 좋은 생각입니다.

 

예제

GSErrCode   err;

err = ACAPI_Goodies (APIAny_UsableGDLStringID, "material", NULL);
/* APIERR_GENERAL을 리턴함, 예약된 키워드임; */
/* 스크립트 변수로 사용할 수 없음 */

err = ACAPI_Goodies (APIAny_UsableGDLStringID, "list", NULL);
/* OK; NoError를 리턴함 */
/* 스크립트 변수로 사용할 수 있음 */

 

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

ACAPI_Goodies,
API 함수