next up previous contents
Next: Спецификация процедуры Up: Термины и соглашения MPI-2 Previous: Система обозначения документа   Contents

Соглашения об именах

MPI-1 использовал неофициальные соглашения об именах. В многих случаях, имена MPI-1 для функций Си имеют форму Class_action_subset (Класс_действие_подмножество) и в языке ФОРТРАН форму CLASS_ACTION_SUBSET (КЛАСС_ДЕЙСТВИЕ_ПОДМНОЖЕСТВО), но это правило не применяется однозначно. В MPI-2 была сделана попытка стандартизировать имена новых функций согласно следующим правилам. Кроме того, привязки С++ для функций MPI-1 также следуют этим правилам (см. Раздел 2.6.4). Имена функций MPI-1 в языках Си и ФОРТРАН не были изменены.

  1. В Си все подпрограммы, связанные со специфическим типом объекта MPI должны иметь форму Class_action_subset либо, если не существует никакое подмножество для функции, форму Class_action. В языке ФОРТРАН все подпрограммы, связанные со специфическим типом объекта MPI, должны иметь форму CLASS_ACTION_SUBSET или, если не существует никакое подмножество для функции, форму CLASS_ACTION. Для языка С++ мы используем терминологию Си и ФОРТРАН, чтобы определить Class. В С++ подпрограмма является методом класса Class и названа MPI::Class::Action_subset. Если подпрограмма связана с некоторым классом, но не имеет смысла как объектный метод, она - статическая функция-член класса.
  2. Если подпрограмма не связана с классом, имя должно иметь форму Action_subset в Си, либо ACTION_SUBSET в языке ФОРТРАН, и в С++ должно быть определено в пространстве имен MPI в форме MPI::Action_subset.
  3. Имена некоторых действий были стандартизированы. В частности Create создает новый объект, Get возвращает информацию об объекте, Set устанавливает эту информацию, Delete удаляет информацию, Is спрашивает, действительно ли объект имеет некоторое свойство.

Имена языка Си и ФОРТРАН для функций MPI-1 нарушают эти правила в некоторых случаях. Наиболее обычные исключения - вычеркивание имени Class из подпрограммы и вычеркивания Action, где подобное может подразумеваться.

Идентификаторы MPI ограничены 30 символами (31 с интерфейсом профилирования). Это сделано, чтобы избежать превышения предела на некоторых системах компиляции.



Alex Otwagin 2002-12-10