Instrukcje: uzyskiwanie dostępu do znaków w klasie System::String

Możesz uzyskać dostęp do znaków obiektu String na potrzeby wywołań funkcji niezarządzanych o wysokiej wydajności, które przyjmują ciągi wchar_t*. Metoda zwraca wskaźnik wewnętrzny do pierwszego znaku String obiektu. Na tym wskaźniku można operować bezpośrednio albo przypiąć go w pamięci i przekazać do funkcji oczekującej zwykłego ciągu wchar_t.

Ważna

Wskaźniki wewnętrzne do String obiektów muszą być traktowane jako const. String Obiekt jest uznawany za niezmienny i zmiana jego zawartości może zdestabilizować środowisko uruchomieniowe. Aby uzyskać więcej informacji, zobacz Niebezpieczne najlepsze rozwiązania dotyczące kodu — 17. Mutacje ciągów.

Przykłady

PtrToStringChars zwraca Char, który jest wskaźnikiem wewnętrznym (znanym również jako byref). W związku z tym podlega odśmiecaniu pamięci. Nie musisz przypinać tego wskaźnika, chyba że zamierzasz przekazać go do funkcji natywnej.

Spójrzmy na poniższy kod. Przypinanie nie jest potrzebne, ponieważ ppchar jest wskaźnikiem wewnętrznym, a jeśli moduł odśmiecający przeniesie ciąg znaków, na który wskazuje, zaktualizuje również ppchar. Bez elementu pin_ptr (C++/CLI) kod będzie działał i nie spowoduje potencjalnego spadku wydajności wynikającego z przypinania.

Jeśli przekażesz ppchar do funkcji natywnej, musi to być wskaźnik przypinający; moduł odśmiecający nie będzie mógł zaktualizować żadnych wskaźników w niezarządzanej ramce stosu.

// PtrToStringChars.cpp
// compile with: /clr
#include <vcclr.h>
using namespace System;

int main() {
   String ^ mystring = "abcdefg";

   interior_ptr<const Char> ppchar = PtrToStringChars( mystring );

   for ( ; *ppchar != L'\0'; ++ppchar )
      Console::Write(*ppchar);
}
abcdefg

W tym przykładzie pokazano, gdzie potrzebne jest przypinanie.

// PtrToStringChars_2.cpp
// compile with: /clr
#include <string.h>
#include <vcclr.h>
// using namespace System;

size_t getlen(System::String ^ s) {
   // Since this is an outside string, we want to be secure.
   // To be secure, we need a maximum size.
   size_t maxsize = 256;
   // make sure it doesn't move during the unmanaged call
   pin_ptr<const wchar_t> pinchars = PtrToStringChars(s);
   return wcsnlen(pinchars, maxsize);
}

int main() {
   System::Console::WriteLine(getlen("testing"));
}
7

Wskaźnik wewnętrzny ma wszystkie właściwości natywnego wskaźnika C++. Można na przykład użyć go do przechodzenia po strukturze danych połączonej wskaźnikami oraz do wykonywania wstawień i usunięć przy użyciu tylko jednego wskaźnika:

// PtrToStringChars_3.cpp
// compile with: /clr /LD
using namespace System;
ref struct ListNode {
   Int32 elem;
   ListNode ^ Next;
};

void deleteNode( ListNode ^ list, Int32 e ) {
   interior_ptr<ListNode ^> ptrToNext = &list;
   while (*ptrToNext != nullptr) {
      if ( (*ptrToNext) -> elem == e )
         *ptrToNext = (*ptrToNext) -> Next;   // delete node
      else
         ptrToNext = &(*ptrToNext) -> Next;   // move to next node
   }
}

Zobacz też

Korzystanie z międzyoperacyjności języka C++ (niejawna funkcja PInvoke)