Compartilhar via


Como: Caracteres de acesso em um sistema::String

Você pode acessar caracteres de um String objeto para chamadas de alto desempenho para funções não gerenciadas que levar wchar_t* cadeias de caracteres. O método produz um ponteiro para o primeiro caractere do interiorString objeto. Esse ponteiro pode ser manipulado diretamente ou fixado e passado para uma função esperando um comum wchar_t seqüência de caracteres.

Exemplo

PtrToStringChars Retorna um Char, que é um ponteiro interior (também conhecido sistema autônomo um byref). sistema autônomo tal, ele está sujeitas a coleta de lixo.Você não precise fixar esse ponteiro, a menos que você vai passá-lo para um nativo função.

Considere o código a seguir.Fixando não é necessária porque ppchar é um ponteiro de interior e se a seqüência de caracteres é movido para o coletor de lixo ele aponta para, também serão atualização ppchar. Sem um pin_ptr, o código funcionará e não têm o potencial impacto no desempenho causado pela fixação.

Se você passar ppchar para uma função nativa, em seguida, ele deve ser um ponteiro pinning; o coletor de lixo não será capaz de atualizar qualquer ponteiros no registro de ativação não gerenciada.

// 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

Este exemplo mostra onde a fixação é necessária.

// 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

Um ponteiro interior tem todas as propriedades de um ponteiro C++ nativo.Por exemplo, você poderá usá-lo a percorrer uma estrutura de dados vinculado e fazer inserções e exclusões usando somente um ponteiro:

// 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
   }
}

Consulte também

Referência

Usando a interoperabilidade de C++ (PInvoke implícita)