複数次元のオブジェクトの情報を取得する関数の引数の統一

[mnakao]

7.5章とAppendix B.2の「Mapping Inquiry Functions」で定義されている、複数次元のオブジェクトの情報を取得する関数について、その関数から得られる値が、各次元の情報なのか、全次元の情報なのかがバラバラなので、統一することを提案する。

• 各次元の情報の方が多い（各次元が16に対して全次元は2）
• 実際に利用する場合は、各次元の情報さえあればよいことが多い
• 以上から各次元に統一することを提案する

以下、各関数のメモ。

• 各次元の情報が返ってくる
  • int xmp_nodes_index(xmp_desc_t d, int dim, int *index);
  • int xmp_nodes_size(xmp_desc_t d, int dim, int *size);
  • int xmp_template_lbound(xmp_desc_t d, int dim, int *lbound);
  • int xmp_template_ubound(xmp_desc_t d, int dim, int *ubound);
  • int xmp_dist_format(xmp_desc_t d, int dim, int *format);
  • int xmp_dist_blocksize(xmp_desc_t d, int dim, int block size);
  • int xmp_dist_gblockmap(xmp_desc_t d, int ndim, int map[]);
  • int xmp_dist_axis(xmp_desc_t d, int dim, int *axis);
  • int xmp_align_axis(xmp_desc_t d, int dim, int *axis);
  • int xmp_align_offset(xmp_desc_t d, int dim, int *offset);
  • int xmp_align_replicated(xmp_desc_t d, int dim, int *replicated);
  • int xmp_array_lshadow(xmp_desc_t d, int dim, int *lshadow);
  • int xmp_array_ushadow(xmp_desc_t d, int dim, int *ushadow);
  • int xmp_array_lbound(xmp_desc_t d, int dim, int *lbound);
  • int xmp_array_ubound(xmp_desc_t d, int dim, int *ubound);
  • int xmp_array_lsize(xmp_desc_t d, int dim, int size);
• 全次元の情報が返ってくる
  • int xmp_array_gtol(xmp_desc_t d, int g_idx, int l_idx);
  • int xmp_array_lead_dim(xmp_desc_t d, int *size);

[mnakao]

下記の2つのように変更する。

• int xmp_array_gtol(xmp_desc_t d, int dim, int g_idx, int *l_idx);
• int xmp_array_lead_dim(xmp_desc_t d, int dim int *size);

[mnakao]

下記のようにする。xmp_array_ldaは#42を参照

• int xmp_array_gtol(xmp_desc_t d, int dim, int g_idx, int *l_idx);
• int xmp_array_lda(xmp_desc_t d, int *size);