Platform::StringReference 클래스

최저의 복사 작업으로 Platform::String^ 입력 매개 변수의 문자열 데이터를 다른 메서드로 전달하는 데 사용할 수 있는 최적화 형식입니다.

구문

class StringReference

설명

멤버

공용 생성자

속성	설명
StringReference::StringReference	StringReference인스턴스를 만드는 두 개의 생성자입니다.

공용 메서드

이름	설명
StringReference::D ata	문자열 데이터를 char16 값의 배열로 반환합니다.
StringReference::Length	문자열의 문자 수를 반환합니다.
StringReference::GetHSTRING	문자열 데이터를 HSTRING으로 반환합니다.
StringReference::GetString	문자열 데이터를 Platform::String^로 반환합니다.

Public 연산자

이름	설명
StringReference::operator=	새 StringReference 인스턴스에 StringReference 를 할당합니다.
StringReference::operator()	StringReference 를 Platform::String^로 변환합니다.

요구 사항

지원되는 최소 클라이언트: Windows 8

지원되는 최소 서버: Windows Server 2012

네임스페이스: Platform

헤더: vccorlib.h

StringReference::Data 메서드

이 StringReference의 콘텐츠를 char16 값의 배열로 반환합니다.

구문

const ::default::char16 * Data() const;

Return Value

char16 유니코드 텍스트 문자의 배열입니다.

StringReference::GetHSTRING 메서드

문자열의 내용을 __abi_HSTRING으로 반환합니다.

구문

__abi_HSTRING GetHSTRING() const;

Return Value

문자열 데이터가 포함된 __abi_HSTRING입니다.

설명

StringReference::GetString 메서드

문자열의 내용을 Platform::String^로 반환합니다.

구문

__declspec(no_release_return) __declspec(no_refcount)
    ::Platform::String^ GetString() const;

Return Value

문자열 데이터가 포함된 Platform::String^입니다.

StringReference::Length 메서드

문자열의 문자 수를 반환합니다.

구문

unsigned int Length() const;

Return Value

문자열에 있는 문자의 수를 지정하는 부호 없는 정수입니다.

설명

StringReference::operator= 연산자

지정한 개체를 현재 StringReference 개체에 할당합니다.

구문

StringReference& operator=(const StringReference& __fstrArg);
StringReference& operator=(const ::default::char16* __strArg);

매개 변수

__fstrArg
현재 StringReference 개체를 초기화하는 데 사용되는 StringReference 개체의 주소입니다.

__strArg
현재 StringReference 개체를 초기화하는 데 사용되는 char16 값의 배열에 대한 포인터입니다.

Return Value

StringReference 형식의 개체에 대한 참조입니다.

설명

StringReference ref 클래스가 아닌 표준 C++ 클래스이므로 개체 브라우저에 표시되지 않습니다.

StringReference::operator() 연산자

개체를 StringReference 개체로 Platform::String^ 변환합니다.

구문

__declspec(no_release_return) __declspec(no_refcount)
         operator ::Platform::String^() const;

Return Value

Platform::String 형식의 개체에 대한 핸들입니다.

StringReference::StringReference 생성자

StringReference 클래스의 새 인스턴스를 초기화합니다.

구문

StringReference();
StringReference(const StringReference& __fstrArg);
StringReference(const ::default::char16* __strArg);
StringReference(const ::default::char16* __strArg, size_t __lenArg);

매개 변수

__fstrArg
새 인스턴스를 초기화하는 데 해당 데이터가 사용되는 StringReference입니다.

__strArg
새 인스턴스를 초기화하는 데 사용되는 char16 값의 배열에 대한 포인터입니다.

__lenArg
의 요소 수입니다 __strArg.

설명

이 생성자의 첫 번째 버전은 기본 생성자입니다. 두 번째 버전은 StringReference 매개 변수로 지정된 개체에서 새 __fstrArg 인스턴스 클래스를 초기화합니다. 세 번째 및 네 번째 오버로드는 char16 값의 배열에서 새 StringReference 인스턴스를 초기화합니다. char16은 16비트 유니코드 텍스트 문자를 나타냅니다.

참고 항목

Platform::StringReference 클래스