Platform::String 클래스Platform::String Class

텍스트를 나타내는 데 사용되는 유니코드 문자의 순차적인 컬렉션을 나타냅니다.Represents a sequential collection of Unicode characters that is used to represent text. 자세한 내용 및 예제에 대 한 참조 문자열합니다.For more information and examples, see Strings.

구문Syntax


public ref class String sealed : Object,  
    IDisposable,  
    IEquatable,  
    IPrintable  

반복기Iterators

String 클래스의 멤버가 아닌 두 반복기 함수를 std::for_each 템플릿 함수와 함께 사용하여 String 개체의 문자를 열거할 수 있습니다.Two iterator functions, which are not members of the String class, can be used with the std::for_each template function to enumerate the characters in a String object.

멤버Member 설명Description
const char16* begin(String^ s) 지정된 String 개체의 시작 부분에 대한 포인터를 반환합니다.Returns a pointer to the beginning of the specified String object.
const char16* end(String^ s) 지정된 String 개체의 끝을 지나는 포인터를 반환합니다.Returns a pointer past the end of the specified String object.

멤버Members

String 클래스는 Object 및 IDisposable, IEquatable 및 IPrintable 인터페이스에서 상속합니다.The String class inherits from Object, and the IDisposable, IEquatable, and IPrintable interfaces.

String 클래스에는 다음 형식의 멤버도 있습니다.The String class also has the following types of members.

생성자Constructors

멤버Member 설명Description
String:: stringString::String String 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the String class.

메서드Methods

String 클래스는 Platform::Object Class의 Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() 및 ToString() 메서드를 상속합니다.The String class inherits the Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), and ToString() methods from the Platform::Object Class. String에는 다음 메서드도 있습니다.String also has the following methods.

메서드Method 설명Description
String:: beginString::Begin 현재 문자열의 시작 부분에 대한 포인터를 반환합니다.Returns a pointer to the beginning of the current string.
String:: compareordinalString::CompareOrdinal 개체가 나타내는 두 문자열 값에서 해당 문자의 숫자 값을 계산하여 두 String 개체를 비교합니다.Compares two String objects by evaluating the numeric values of the corresponding characters in the two string values represented by the objects.
String:: concatString::Concat 두 String 개체의 값을 연결합니다.Concatenates the values of two String objects.
String:: dataString::Data 현재 문자열의 시작 부분에 대한 포인터를 반환합니다.Returns a pointer to the beginning of the current string.
String:: disposeString::Dispose 리소스를 확보하거나 해제합니다.Frees or releases resources.
String:: endString::End 현재 문자열의 끝을 지나는 포인터를 반환합니다.Returns a pointer past the end of the current string.
String:: equalsString::Equals 지정된 개체가 현재 개체와 같은지 여부를 나타냅니다.Indicates whether the specified object is equal to the current object.
String:: gethashcodeString::GetHashCode 이 인스턴스의 해시 코드를 반환합니다.Returns the hash code for this instance.
String:: isemptyString::IsEmpty 현재 String 개체가 비어 있는지 여부를 나타냅니다.Indicates whether the current String object is empty.
String:: isfastpassString::IsFastPass 현재 String 개체가 빠른 전달 작업에 참여하고 있는지를 나타냅니다.Indicates whether the current String object is is participating in a fast pass operation. 빠른 전달 작업에서는 참조 횟수가 일시 중단됩니다.In a fast pass operation, reference counting is suspended.
String:: lengthString::Length 현재 String 개체의 길이를 검색합니다.Retrieves the length of the current String object.
String:: tostringString::ToString 현재 문자열과 같은 값을 갖는 String 개체를 반환합니다.Returns a String object whose value is the same as the current string.

연산자Operators

String 클래스에는 다음과 같은 연산자입니다.The String class has the following operators.

멤버Member 설명Description
String:: operator = = 연산자String::operator== Operator 지정된 두 String 개체의 값이 같은지 여부를 나타냅니다.Indicates whether two specifed String objects have the same value.
operator+ Operatoroperator+ Operator 두 String 개체를 새 String 개체에 연결합니다.Concatenates two String objects into a new String object.
String:: operator > 연산자String::operator> Operator String 개체 값이 두 번째 String 개체 값보다 큰지 여부를 나타냅니다.Indicates whether the value of one String object is greater than the value of a second String object.
String:: operator > = 연산자String::operator>= Operator String 개체 값이 두 번째 String 개체 값보다 크거나 같은지 여부를 나타냅니다.Indicates whether the value of one String object is greater than or equal to the value of a second String object.
String:: operator! = 연산자String::operator!= Operator 지정된 두 String 개체의 값이 다른지 여부를 나타냅니다.Indicates whether two specifed String objects have different values.
String:: operator < 연산자String::operator< Operator String 개체 값이 두 번째 String 개체 값보다 작은지 여부를 나타냅니다.Indicates whether the value of one String object is less than the value of a second String object.

요구 사항Requirements

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

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

네임스페이스: PlatformNamespace: Platform

헤더 vccorlib.h(기본적으로 포함)Header vccorlib.h (included by default)

String:: begin 메서드String::Begin Method

현재 문자열의 시작 부분에 대한 포인터를 반환합니다.Returns a pointer to the beginning of the current string.

구문Syntax


char16* Begin()  

반환 값Return Value

현재 문자열의 시작 부분에 대한 포인터입니다.A pointer to the beginning of the current string.

String:: compareordinal 메서드String::CompareOrdinal Method

개체가 나타내는 두 문자열 값에서 해당 문자의 숫자 값을 계산하여 두 String 개체를 비교합니다.Compares two String objects by evaluating the numeric values of the corresponding characters in the two string values represented by the objects.

구문Syntax


int CompareOrdinal(  
           String^ str1,   
           String^ str2)  

매개 변수Parameters

str1
첫 번째 String 개체입니다.The first String object.

str2
두 번째 String 개체입니다.The second String object.

반환 값Return Value

두 비교 대상 간의 어휘 관계를 나타내는 정수입니다.An integer that indicates the lexical relationship between the two comparands. 다음 표에서는 가능한 반환 값을 보여 줍니다.The following table lists the possible return values.

Value 조건Condition
-1-1 str1str2보다 작은 경우str1 is less than str2.
00 str1str2와 같은 경우str1 is equals str2.
11 str1str2보다 큰 경우str1 is greater than str2.

String:: concat 메서드String::Concat Method

두 String 개체의 값을 연결합니다.Concatenates the values of two String objects.

구문Syntax

String^ Concat( String^ str1, String^ str2)  

매개 변수Parameters

str1
첫 번째 String 개체 또는 null입니다.The first String object, or null.

str2
두 번째 String 개체 또는 null입니다.The second String object, or null.

반환 값Return Value

str1 값과 str2 값의 연결을 값으로 하는 새로운 String^ 개체입니다.A new String^ object whose value is the concatenation of the values of str1 and str2.

경우 str1nullstr2 는 사용 되지 않는 str1 반환 됩니다.If str1 is null and str2 is not, str1 is returned. 경우 str2nullstr1 는 사용 되지 않는 str2 반환 됩니다.If str2 is null and str1 is not, str2 is returned. str1str2가 모두 null이면 빈 문자열(L"")이 반환됩니다.If str1 and str2 are both null, the empty string (L"") is returned.

String:: data 메서드String::Data Method

개체의 데이터 버퍼 시작에 대한 포인터를 char16(wchar_t) 요소의 C 스타일 배열로 반환합니다.Returns a pointer to the beginning of the object's data buffer as a C-style array of char16 (wchar_t) elements.

구문Syntax

const char16* Data()  

반환 값Return Value

시작 부분에 대 한 포인터는 const char16 유니코드 문자 배열 (char16 에 대 한 typedef wchar_t).A pointer to the beginning of a const char16 array of Unicode characters (char16 is a typedef for wchar_t).

설명Remarks

이 메서드를 사용하여 Platform::String^에서 wchar_t*로 변환합니다.Use this method to convert from Platform::String^ to wchar_t*. String 개체가 범위를 벗어나는 경우 데이터 포인터의 유효성이 더 이상 보장되지 않습니다.When the String object goes out of scope, the Data pointer is no longer guaranteed to be valid. 원래의 수명 넘어서는 데이터를 저장 하려면 String 개체를 가져오려면 wcscpy_s 직접 할당 한 메모리로 배열을 복사 합니다.To store the data beyond the lifetime of the original String object, use wcscpy_s to copy the array into memory that you have allocated yourself.

String:: dispose 메서드String::Dispose Method

리소스를 확보하거나 해제합니다.Frees or releases resources.

구문Syntax


virtual override void Dispose()  

String:: end 메서드String::End Method

현재 문자열의 끝을 지나는 포인터를 반환합니다.Returns a pointer past the end of the current string.

구문Syntax


char16* End()  

반환 값Return Value

현재 문자열의 끝을 지나는 포인터입니다.A pointer to past the end of the current string.

설명Remarks

End ()는 begin () + Length를 반환 합니다.End() returns Begin() + Length.

String:: equals 메서드String::Equals Method

지정된 String의 값이 현재 개체와 동일한지 여부를 나타냅니다.Indicates whether the specified String has the same value as the current object.

구문Syntax


bool String::Equals(Object^ str);  

bool String::Equals(String^ str);  

매개 변수Parameters

str
비교할 개체입니다.The object to compare.

반환 값Return Value

true이 현재 개체와 같으면 str이고, 그렇지 않으면 false입니다.true if str is equal to the current object; otherwise, false.

설명Remarks

이 메서드는 해당 하는 string:: compareordinal합니다.This method is equivalent to the String::CompareOrdinal. 첫 번째 오버로드에서는 str 매개 변수가 String^ 개체로 캐스팅될 수 있어야 합니다.In the first overload, it is expected the str parameter can be cast to a String^ object.

String:: gethashcode 메서드String::GetHashCode Method

이 인스턴스의 해시 코드를 반환합니다.Returns the hash code for this instance.

구문Syntax


virtual override int GetHashCode()  

반환 값Return Value

이 인스턴스의 해시 코드입니다.The hash code for this instance.

String:: isempty 메서드String::IsEmpty Method

현재 String 개체가 비어 있는지 여부를 나타냅니다.Indicates whether the current String object is empty.

구문Syntax

bool IsEmpty()  

반환 값Return Value

현재 String 개체가 true 또는 빈 문자열(L"")이면 null이고, 그렇지 않으면 false입니다.true if the current String object is null or the empty string (L""); otherwise, false.

String:: isfastpass 메서드String::IsFastPass Method

현재 String 개체가 빠른 전달 작업에 참여하고 있는지를 나타냅니다.Indicates whether the current String object is is participating in a fast pass operation. 빠른 전달 작업에서는 참조 횟수가 일시 중단됩니다.In a fast pass operation, reference counting is suspended.

구문Syntax

bool IsFastPass();  

반환 값Return Value

현재 String 개체가 fast-past이면 true이고, 그렇지 않으면 false입니다.true if the current String object is fast-past; otherwise, false.

설명Remarks

참조 횟수가 계산된 개체가 매개 변수이고, 호출된 함수가 이 개체만 읽는 함수에 대한 호출인 경우 컴파일러는 참조 횟수를 안전하게 일시 중단하고 호출 성능을 향상시킬 수 있습니다.In a call to a function where a reference-counted object is a parameter, and the called function only reads that object, the compiler can safely suspend reference counting and improve calling performance. 코드에서 이 속성으로 할 수 있는 유용한 일은 없습니다.There is nothing useful that your code can do with this property. 시스템에서 모든 세부 사항을 처리합니다.The system handles all the details.

String:: length 메서드String::Length Method

현재 String 개체의 문자 수를 검색합니다.Retrieves the number of characters in the current String object.

구문Syntax

unsigned int Length()  

반환 값Return Value

현재 String 개체의 문자 수입니다.The number of characters in the current String object.

설명Remarks

문자가 없는 String의 길이는 0입니다.The length of a String with no characters is zero. 다음 String의 길이는 5입니다.The length of the following string is 5:

String^ str = "Hello";  
int len = str->Length(); //len = 5  

문자 배열에서 반환 되는 string:: data 종결 NULL 또는 '\0' 인 추가 문자열이 하나 있습니다.The character array returned by the String::Data has one additional character, which is the terminating NULL or '\0'. 이 문자의 길이도 2바이트입니다.This character is also two bytes long.

String:: operator + 연산자String::operator+ Operator

두 개의 연결 문자열 새 개체 문자열 개체입니다.Concatenates two String objects into a new String object.

구문Syntax


bool String::operator+( String^ str1, String^ str2)  

매개 변수Parameters

str1
첫 번째 String 개체입니다.The first String object.

str2
내용이 String에 추가될 두 번째str1 개체입니다.The second String object, whose contents will be appended to str1.

반환 값Return Value

truestr1와 같으면 str2이고, 그러지 않으면 false입니다.true if str1 is equal to str2; otherwise, false.

설명Remarks

이 연산자는 두 피연산자의 데이터가 들어 있는 String^ 개체를 만듭니다.This operator creates a String^ object that contains the data from the two operands. 매우 높은 성능이 중요하지 않은 경우 편의를 위해 이를 사용합니다.Use it for convenience when extreme performance is not critical. 함수에서 "+"를 몇 번 호출하는 것은 그렇게 눈에 띄지 않지만 대행 개체나 텍스트 데이터를 연속해서 조작하는 경우 표준 C++ 매커니즘과 형식을 사용하십시오.A few calls to "+" in a function will probably not be noticeable, but if you are manipulating large objects or text data in a tight loop, then use the standard C++ mechanisms and types.

String:: operator = = 연산자String::operator== Operator

지정된 두 String 개체의 텍스트 값이 같은지 여부를 나타냅니다.Indicates whether two specified String objects have the same text value.

구문Syntax

bool String::operator==( String^ str1, String^ str2)  

매개 변수Parameters

str1
비교할 첫 번째 String 개체입니다.The first String object to compare.

str2
비교할 두 번째 String 개체입니다.The second String object to compare.

반환 값Return Value

true의 내용이 str1와 같으면 str2이고, 그렇지 않으면 false입니다.true if the contents of str1 are equal to str2; otherwise, false.

설명Remarks

이 연산자는 같음 string:: compareordinal합니다.This operator is equivalent to String::CompareOrdinal.

String:: operator>String::operator>

String 개체 값이 두 번째 String 개체 값보다 큰지 여부를 나타냅니다.Indicates whether the value of one String object is greater than the value of a second String object.

구문Syntax

bool String::operator>( String^ str1, String^ str2)  

매개 변수Parameters

str1
첫 번째 String 개체입니다.The first String object.

str2
두 번째 String 개체입니다.The second String object.

반환 값Return Value

str1의 값이 str2의 값보다 크면 true이고, 그렇지 않으면 false입니다.true if the value of str1 is greater than the value of str2; otherwise, false.

설명Remarks

명시적으로 호출 하는 것이 연산자는 string:: compareordinal 고 0 보다 큰 결과 가져오는 합니다.This operator is equivalent to explicitly calling String::CompareOrdinal and getting a result greater than zero.

String:: operator>=String::operator>=

String 개체 값이 두 번째 String 개체 값보다 크거나 같은지 여부를 나타냅니다.Indicates whether the value of one String object is greater than or equal to the value of a second String object.

구문Syntax

bool String::operator>=( String^ str1, String^ str2) 

매개 변수Parameters

str1
첫 번째 String 개체입니다.The first String object.

str2
두 번째 String 개체입니다.The second String object.

반환 값Return Value

str1의 값이 str2의 값보다 크거나 같으면 true이고, 그렇지 않으면 false입니다.true if the value of str1 is greater than or equal to the value of str2; otherwise, false.

String:: operator! =String::operator!=

지정된 두 String 개체의 값이 다른지 여부를 나타냅니다.Indicates whether two specifed String objects have different values.

구문Syntax

bool String::operator!=( String^ str1, String^ str2)  

매개 변수Parameters

str1
비교할 첫 번째 String 개체입니다.The first String object to compare.

str2
비교할 두 번째 String 개체입니다.The second String object to compare.

반환 값Return Value

truestr1와 다르면 str2이고, 그러지 않으면 false입니다.true if str1 is not equal to str2; otherwise, false.

String:: operator<String::operator<

String 개체 값이 두 번째 String 개체 값보다 작은지 여부를 나타냅니다.Indicates whether the value of one String object is less than the value of a second String object.

구문Syntax

bool String::operator<( String^ str1, String^ str2)  

매개 변수Parameters

str1
첫 번째 String 개체입니다.The first String object.

str2
두 번째 String 개체입니다.The second String object.

반환 값Return Value

str1의 값이 str2의 값보다 작으면 true이고, 그렇지 않으면 false입니다.true if the value of str1 is less than the value of str2; otherwise, false.

String:: string 생성자String::String Constructor

입력 문자열 데이터의 복사본을 사용하여 String 클래스의 새 인스턴스를 초기화합니다.Initializes a new instance of the String class with a copy of the input string data.

구문Syntax

String();    
String(char16* s)  
String(char16* s, unsigned int n)  

매개 변수Parameters

s
문자열을 초기화하는 일련의 와이드 문자입니다.A series of wide characters that initialize the string. char16char16

n
문자열의 길이를 지정하는 숫자입니다.A number that specifies the length of the string.

설명Remarks

성능이 중요 하며 소스 문자열의 수명을 제어 하는 경우 사용할 수 있습니다 platform:: stringreference 문자열 대신 합니다.If performance is critical and you control the lifetime of the source string, you can use Platform::StringReference in place of String.

Example

String^ s = L"Hello!";  

String:: tostringString::ToString

현재 문자열과 같은 값을 갖는 String 개체를 반환합니다.Returns a String object whose value is the same as the current string.

구문Syntax

String^ String::ToString()  

반환 값Return Value

현재 문자열과 같은 값을 갖는 String 개체입니다.A String object whose value is the same as the current string.

참고 항목See Also

Platform 네임 스페이스Platform namespace