mxCalcSingleSubscript (Fortran)

Смещение от первого элемента к требуемому элементу

Синтаксис языка ФОРТРАН

#include "fintrf.h"
mwIndex mxCalcSingleSubscript(pm, nsubs, subs)
mwPointer pm
mwSize nsubs
mwIndex subs

Описание

Звонить mxCalcSingleSubscript определить, сколько элементов находится между началом mxArray и заданный элемент этого mxArray. Функция преобразует индексы в линейные индексы.

Для примера, с учетом индекса, подобного (5,7), mxCalcSingleSubscript возвращает расстояние от первого элемента массива к (5,7) элемент. Помните, что mxArray тип данных внутренне представляет все элементы данных в одномерном массиве независимо от того, сколько размерности MATLAB® mxArray по-видимому, имеет. Для примеров, показывающих внутреннее представление, смотрите Хранение данных.

Входные параметры

расширить все

Указатель на mxArray массив, заданный как mwPointer.

Количество элементов в subs массив, заданный как mwSize. Как правило, вы задаете nsubs равным количеству размерностей в mxArray что pm указывает на.

Массив нижних индексов, заданный как mwIndex. Каждое значение в массиве задает нижний индекс размерности. Значение в subs(1) задает индекс строки и значение в subs(2) задает индекс столбца. Используйте индексацию на основе 1 для индексов. Для примера выразить стартовый элемент массива двумерную mxArray в subs, задать subs(1) на 1 и subs(2) на 1.

Возвраты

Количество элементов или index между началом mxArray и заданный индекс. Это число является линейным индексным эквивалентом индексов. Многие стандартные программы библиотеки матриц (для примера, mxGetField) требуется индекс в качестве аргумента.

Если subs описывает стартовый элемент mxArray, mxCalcSingleSubscript возвращает 0. Если subs описывает конечный элемент mxArray, mxCalcSingleSubscript возвращает N-1 (где N - общее количество элементов).

См. также

|

Представлено до R2006a