Files
eiffel-org/documentation/current/solutions/other-languages/cecil/cecil-reference/eif-adopt.wiki
halw 07b32c8be2 Overhaul.
Author:halw
Date:2011-03-06T17:25:15.000000Z


git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@801 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
2011-03-06 17:25:15 +00:00

28 lines
1.1 KiB
Plaintext

[[Property:title|Reference for `eif_adopt']]
[[Property:link_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 <code lang="text">eif_access()</code>.
==Conformance==
ISE Eiffel 4.1 and later.
{{SeeAlso| <br/>
[[Reference for `eif_access']]<br/>
[[Reference for `eif_protect']]<br/>
[[Reference for `eif_wean']] }}