The MATLAB online documentation about the default API used by mex is confusing.

Here:
http://www.mathworks.com/help/techdoc/matlab_external/bsflnue-1.html

it says: 

""MEX Uses 64-Bit API by Default
  
The default mex build option now uses the -largeArrayDims flag. If you build with this flag, mex uses the 64-bit API.""


On the other hand here:
http://www.mathworks.com/help/techdoc/ref/mex.html

It says:

""-compatibleArrayDims

Build a binary MEX-file using the MATLAB Version 7.2 array-handling API, which limits arrays to 2^31-1 elements. This option is the default, but in the future the -largeArrayDims option will be the default.""


Both these are from the documentation for R2010b. As of 2010b which of these two is true? Does anybody know when did/will -largeArrayDims option become default?

Thanks,
Saurabh

"Saurabh " <sjain@math.uh.edu> wrote in message <i8lenk$1h7$1@fred.mathworks.com>...
> The MATLAB online documentation about the default API used by mex is confusing.
> 
> Here:
> http://www.mathworks.com/help/techdoc/matlab_external/bsflnue-1.html
> 
> it says: 
> 
> ""MEX Uses 64-Bit API by Default
>   
> The default mex build option now uses the -largeArrayDims flag. If you build with this flag, mex uses the 64-bit API.""
> 
> 
> On the other hand here:
> http://www.mathworks.com/help/techdoc/ref/mex.html
> 
> It says:
> 
> ""-compatibleArrayDims
> 
> Build a binary MEX-file using the MATLAB Version 7.2 array-handling API, which limits arrays to 2^31-1 elements. This option is the default, but in the future the -largeArrayDims option will be the default.""
> 
> Both these are from the documentation for R2010b. As of 2010b which of these two is true? Does anybody know when did/will -largeArrayDims option become default?
> 

My understanding is that R2010b was going to be the first version where -largeArrayDims became the default, but I have yet to install R2010b and confirm that. If you want to know, just compile a simple mex file and print out the size of mwSize, mwSignedIndex, etc.

James Tursa

"James Tursa" <aclassyguy_with_a_k_not_a_c@hotmail.com> wrote in message <i8lfc8$bgd$1@fred.mathworks.com>...
> "Saurabh " <sjain@math.uh.edu> wrote in message <i8lenk$1h7$1@fred.mathworks.com>...
> > The MATLAB online documentation about the default API used by mex is confusing.
> > 
> > Here:
> > http://www.mathworks.com/help/techdoc/matlab_external/bsflnue-1.html
> > 
> > it says: 
> > 
> > ""MEX Uses 64-Bit API by Default
> >   
> > The default mex build option now uses the -largeArrayDims flag. If you build with this flag, mex uses the 64-bit API.""
> > 
> > 
> > On the other hand here:
> > http://www.mathworks.com/help/techdoc/ref/mex.html
> > 
> > It says:
> > 
> > ""-compatibleArrayDims
> > 
> > Build a binary MEX-file using the MATLAB Version 7.2 array-handling API, which limits arrays to 2^31-1 elements. This option is the default, but in the future the -largeArrayDims option will be the default.""
> > 
> > Both these are from the documentation for R2010b. As of 2010b which of these two is true? Does anybody know when did/will -largeArrayDims option become default?
> > 
> 
> My understanding is that R2010b was going to be the first version where -largeArrayDims became the default, but I have yet to install R2010b and confirm that. If you want to know, just compile a simple mex file and print out the size of mwSize, mwSignedIndex, etc.
> 
> James Tursa


Thanks, James. Should have thought of that... As of 2010b, it is still NOT the default. The 2010b release notes say -largeArrayDims will be default in the next release. So, I guess 2011a is when it becomes the default.
-SJ