tocFunctions — By CategoryMAT-File AccessMX Array ManipulationMEX-FilesMATLAB EngineFunctions — Alphabetical ListIndexMATLAB®The Language of Technical ComputingComputationVisualizationProgrammingExternal Interfaces ReferenceVersion 7How to Contact The MathWorkswww.mathworks.comWebcomp.soft-sys.matlab Newsgroupwww.mathworks.com/contact_TS.html Technical [email protected] Product enhancement [email protected] [email protected] Documentation error [email protected] Order status, license renewals, [email protected], pricing, and general information508-647-7000 (Phone)508-647-7001 (Fax)The MathWorks, Inc.3 Apple Hill DriveNatick, MA 01760-2098For contact information about worldwide offices, see the MathWorks Web site.MATLAB External Interfaces Reference© COPYRIG HT 1984–2006 by The MathWorks, Inc.The software described in this document is furnished under a license agreement. The software may be usedor copied only under the terms of the license agreement. No pa rt of this manual may be photocopied orreproduced in any form without prior written consent from The MathWorks, Inc.FEDERAL ACQUISITION: This provision applies to all acquisitions of the Program and Documentationby, for, or through the federal government of the United States. By accepting delivery of the Program orDocumentation, the government hereby agrees that this software or documentation qualifies as commercialcomputer software or commercial computer software documentation as such terms are used or definedin FAR 12.212, DFARS Part 227.72, and D FARS 252.227-7014. A ccordingly, the terms and conditions ofthis Agreement and only those ri ghts specified in this Agreement, shall pertain to and govern the use,modification, reproduction, release, performance, display, and disclosure of the Program and Documentationby the federal government (or other entity acquiring for or through the feder al government) and shallsupersede any conflicting contractual terms or c onditions. If this License fails to me et the government’sneeds or is inconsistent in any respect with federal procurement law, the government agrees to return theProgram and Documentation, unused, to The MathWorks, Inc.TrademarksMATLAB, Si mulink, Stateflow, Handle Graphics, Real-Time Workshop, and xPC TargetBoxare registered trademarks, and SimBiology, SimEvents, and SimHydraulics are trademarks ofThe MathWorks, Inc.Other product or brand names are trademarks or registered trademarks of their respectiveholders.PatentsThe MathWorks products are protected by one or more U.S. patents. P lease seewww.mathworks.com/patents for more information.Revision HistoryDecember 1996 First Printing New for MATLAB 5 (release 8)May 1997 Online only Revised for MATLAB 5.1 (Release 9)January 1998 Online Only Revised for MATLAB 5.2 (Release 10)January 1999 Online Only Revised for MATLAB 5.3 (Release 11)September 2000 Online Only Revised for 6.0 (Release 12)June 2001 Online only Revised for MATLAB 6.1 (Release 12.1)July 2002 Online only Revised for MATLAB 6.5 (Release 13)January 2003 Online only R evised for M ATLAB 6.5.1 (Release 13SP1)June 2004 Online only Revised for MATLAB 7.0 (Release 14)October 2004 Online only Revised for MATLAB 7.0.1 (Release 14SP1)March 2005 Online only Revised for M ATLAB 7.0.4 (Release 14SP2)September 2005 Online only Revised for M ATLAB 7.1 (Release 14SP3)March 2006 Online only Revised for MATLAB 7.2 (Release 2006a)September 2006 Online only Revised for MATLAB 7.3 (Release 2006b)ContentsFunctions — By Category1MAT-File Access...................................1-2MX Array Manipulation............................1-2MEX-Files......................................... 1-9MATLAB Engine...................................1-11Functions —Alphabetical List2Indexvvi Contents1Functions — By CategoryMAT-File Access (p. 1-2)Incorporate and use M ATLAB®datain C and Fortran programsMX Array Manipulation (p. 1-2)Create and manipulate MATLABarrays from C and Fortran MEX andEngine routinesMEX-Files (p. 1-9)Perform operations in MATLABenvironment from C and FortranMEX-filesMATLAB Engine (p. 1-11)Call M ATLAB from C and FortranprogramsSee also “External Interfaces” in MATLAB Function Reference for MATLABinterfaces to DLLs, Java, COM and A ctiveX, DDE, Web services, and serialport devices.1 Functions — By CategoryMAT-File AccessmatClose (C and Fo rtran)Close MAT-filematDeleteVariable (C andFortran)Delete named mxArray from MAT-filematGetDir (C and Fortran)Directory of mxArraysinMAT-filematGetFp (C)File pointer to MAT-filematGetNextVariable (C andFortran)Read next mxArray from MAT-filematGetNextVariableInfo (C andFortran)Load array header information onlymatGetVariable (C and Fortran)Read mxArray sfromMAT-filesmatGetVariableInfo (C andFortran)Load array header information onlymatOpen (C and Fortran)Open MAT-filematPutVariable (C and Fort ran)Write mxAr raystoMAT-filesmatPutVariableAsGlobal (C andFortran)Put m xArr aysintoMAT-filesasoriginating from global workspaceMX Array ManipulationmwIndex (C and For tran)Type for index valuesmwPointer (Fortran)Declare appropriate pointer type forplatformmwSize (C and Fort ran)Type forsize valuesmxAddField (C and Fortran)Add field to structure arraymxArrayToString (C)Convertarray to stringmxAssert (C)Check assertion value for debuggingpurposes1-2MX Array ManipulationmxAssertS (C)Check assertion value withoutprinting assertion textmxCalcSingleSubscript (C andFortran)Offset from f irs t e lement to desiredelementmxCalloc (C and Fo rtran)Allocate dynamic memory for arrayusing MATLAB memory managermxChar (C)Data type for string mxArraymxClassID (C)Integer value identifying class ofmxArraymxClassIDFromClassName(Fortran)Identifier corresponding to classmxComplexity (C)Flag specifying whether mxArrayhas imaginary componentsmxCopyCharacterToPtr (Fortran)Copy character values from Fortranarray to pointer arraymxCopyComplex16ToPtr (Fortran)Copy COMPLEX*16 values fromFortran array to pointer arraymxCopyComplex8ToPtr (Fortran)Copy COMPLEX*8 values from Fortranarray to pointer arraymxCopyInteger1ToPtr (Fortran)Copy INTEGER*1 values from Fortranarray to pointer arraymxCopyInteger2ToPtr (Fortran)Copy INTEGER*2 values from Fortranarray to pointer arraymxCopyInteger4ToPtr (Fortran)Copy INTEGER*4 values from Fortranarray to pointer arraymxCopyPtrToCharacter (Fortran)Copy character values from pointerarray to Fortran arraymxCopyPtrToComplex16 (Fortran)Copy COMPLEX*16 values frompointer