259

I just came across this code and a few Google searches turn up no explanation of this mysterious (to me) syntax.

Hashtable^ tempHash = gcnew Hashtable(iterators_);

IDictionaryEnumerator^ enumerator = tempHash->GetEnumerator();

What the heck does the caret mean? (The gcnew is also new to me, and I asked about that here.)

1

8 Answers 8

209

This is C++/CLI and the caret is the managed equivalent of a * (pointer) which in C++/CLI terminology is called a 'handle' to a 'reference type' (since you can still have unmanaged pointers).

(Thanks to Aardvark for pointing out the better terminology.)

3
  • 8
    Does the (I suppose "unmanaged reference") syntax "&" still exist in C++/CLI?
    – Owen
    Oct 14, 2008 at 19:35
  • C++/CLI is an extension of regular C++, so yes - it is only for unmanaged references though Oct 14, 2008 at 19:59
  • 5
    % is the managed version of a a reference in C++/CLI.
    – AJM
    Mar 2, 2021 at 16:45
109
// here normal pointer
P* ptr = new P; // usual pointer allocated on heap
P& nat = *ptr; // object on heap bind to native object

//.. here CLI managed 
MO^ mngd = gcnew MO; // allocate on CLI heap
MO% rr = *mngd; // object on CLI heap reference to gc-lvalue

In general, the punctuator % is to ^ as the punctuator & is to *. In C++ the unary & operator is in C++/CLI the unary % operator.

While &ptr yields a P*, %mngd yields at MO^.

2
  • 2
    I would rather say why not ^mngd instead of * mngd.. It's confusing all of a sudden allowed to use unmanaged pointer symbol(*), not the managed pointer(^) in front of actually variable declared in managed heap.
    – swcraft
    Jul 22, 2016 at 15:08
  • Thank you! I was looking for an explanation for the % punctuator.
    – Stefan
    Nov 30, 2021 at 16:37
27

It means that this is a reference to a managed object vs. a regular C++ pointer. Objects behind such references are managed by the runtime and can be relocated in the memory. They are also garbage-collected automatically.

2
23

When you allocated managed memory, that memory can be moved around by the garbage collector. The ^ operator is a pointer for managed memory which continues to point to the correct place even if the garbage collector moves the object it points to.

5

In C++/CLI it means a managed pointer. You can read more about it (and other C++/CLI features) here:

http://en.wikipedia.org/wiki/C%2B%2B/CLI

5

From MSDN, it looks like the caret means you are getting a handle to the type being created.

https://web.archive.org/web/20150117095313/http://msdn.microsoft.com/en-us/library/te3ecsc8%28VS.80%29.aspx

2
  • dead link (2018)
    – gbarry
    Apr 17, 2018 at 18:26
  • 2
    fixed the link to archive.org copy. Honestly, MSDN links are so fragile that all new MSDN links should just be run through archive.org from the start.
    – Anssssss
    Dec 12, 2018 at 22:46
2

It means that it is a reference to a managed object.

0

It's also worth considering the following couple of sentences, that put the answer in a slightly different way:

"The handle declarator (^, referred to as "caret" or "hat" or "circumflex"), modifies the type specifier to mean that the declared object should be automatically deleted when the system determines that the object is no longer accessible."

"Because native C++ pointers (*) and references (&) are not managed references, the garbage collector cannot automatically update the addresses they point to. To solve this problem, use the handle declarator to specify a variable that the garbage collector is aware of and can update automatically."

(And "native" is in my humble opinion a better word than 'handle', as handle is possibly a word that was brought more so in by the use of the 'Windows SDK')

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.