tocAPI — By CategoryMAT-File AccessMX Array ManipulationMEX-FilesMATLAB EngineAPI — Alphabetical ListIndexMATLAB®7CandFortranAPIReferenceHow 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 C and Fortran API Reference© COPYRIG HT 1984–2007 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, Simulink, Stateflow, Handle Graphics, Real-Time Workshop, SimBiology,SimHydraulics, SimEvents, and xPC TargetBox are registered trademarks and TheMathWorks, the L-shaped membrane logo, Embedded MATLAB, and PolySpace aretrademarks of The 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. Please 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 MATLAB 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 MATLAB 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)March 2007 Online only Revised and renamed for MATLAB 7.4 (Release 2007a)September 2007 Online only Revised and renamed for MATLAB 7.5 (Release 2007b)ContentsAPI — By Category1MAT-File Access...................................1-2MX Array Manipulation............................1-2MEX-Files......................................... 1-9MATLAB Engine...................................1-11API — Alphabetical List2Indexvvi Contents1API — 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 ActiveX, Web services, and serial portdevices.1 API — By CategoryMAT-File AccessmatClose (C and Fortran)Close MAT-filematDeleteVariable (C andFortran)Delete named mxArray from MAT-fileMATFile (C and Fortran)Type for a M AT-filematGetDir (C and Fortran)Get directory of mxArraysinMAT-filematGetFp (C)Get file pointer to MAT-filematGetNextVariable (C andFortran)Read next mxArray from MAT-filematGetNextVariableInfo (C and Fortran)Load array header information onlymatGetVariable (C and Fortran)Read mxArray sfrom MAT-filesmatGetVariableInfo (C andFortran)Load array header information onlymatOpen (C and Fortran)Open MAT-filematPutVariable (C and Fortran)Write mxAr raystoMAT-filesmatPutVariableAsGlobal (C andFortran)Put m xArr aysintoMAT-filesasoriginating from global workspaceMX Array ManipulationmwIndex (C and Fortran)Type for index valuesmwPointer (Fortran)Declare appropriate pointer type forplatformmwSize (C and Fortran)Type for size valuesmxAddField (C and Fortran)Add field to structure arraymxArray(C and Fortran)Type for a MATLAB arraymxArrayToString (C)Convert array to string1-2MX Array ManipulationmxAssert (C)Check assertion value for debuggingpurposesmxAssertS (C)Check assertion value withoutprinting assertion textmxCalcSingleSubscript (C andFortran)Offset from f irs t e lement to desiredelementmxCalloc (C and Fortran)Allocate dynamic memory for arrayusing MATLAB memory managermxChar (C)Type for string mxArraymxClassID (C)Enumerated value identifying classofmxArraymxClassIDFromClassName(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