Files
eiffel-org/documentation/current/solutions/other-languages/cecil/cecil-reference/eif-adopt.wiki
halw b5884019cd Author:halw
Date:2011-03-07T17:56:33.000000Z


git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@836 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
2011-03-07 18:09:48 +00:00

29 lines
969 B
Plaintext

[[Property:title|eif_adopt]]
[[Property:weight|-13]]
[[Property:uuid|dc8ef8a9-7082-2a27-4e45-8f1d4472dbda]]
==Synopsis==
<code lang="text">
#include "eif_hector.h"
EIF_OBJECT eif_adopt (EIF_OBJECT obj);
</code>
==Description==
The <code lang="text">eif_adopt</code> function adopts <code lang="text">obj</code>. By adopting it, the user prevents <code lang="text">obj</code> from being unprotected automatically by the Eiffel run-time. The run-time protects automatically the Eiffel objects passed to a C external before entering the external and unprotects them after exiting the C external. To keep this protection later on, you must call <code lang="text">eif_adopt</code>.
==Return value==
An <code lang="text">EIF_OBJECT</code>. This return value can be used later to access the nested, protected Eiffel reference with [[eif_access]].
==Conformance==
ISE Eiffel 4.1 and later.
{{SeeAlso| <br/>
[[eif_access]]<br/>
[[eif_protect]]<br/>
[[eif_wean]] }}