Compartir a través de


MPI_Group_union función

Crea un nuevo grupo a partir de la unión de dos grupos existentes.

Sintaxis

int MPIAPI MPI_Group_union(
        MPI_Group group1,
        MPI_Group group2,
  _Out_ MPI_Group *newgroup
);

Parámetros

  • group1
    Primer grupo.

  • group2
    Segundo grupo.

  • newgroup [out]
    En la devolución, contiene un puntero a un nuevo grupo que representa todos los elementos de cualquiera de los grupos.

Valor devuelto

Devuelve MPI_SUCCESS si se realiza correctamente. De lo contrario, el valor devuelto es un código de error.

En Fortran, el valor devuelto se almacena en el parámetro IERROR .

Fortran

    MPI_GROUP_UNION(GROUP1, GROUP2, NEWGROUP, IERROR)
        INTEGER GROUP1, GROUP2, NEWGROUP, IERROR 

Comentarios

Se trata de una operación local. Los distintos procesos pueden definir grupos distintos. Un proceso puede definir un grupo que no se incluye a sí mismo.

La implementación de MPI no proporciona un mecanismo para crear un grupo desde cero, sino solo desde grupos existentes. El grupo base, en el que se definen todos los demás grupos, se puede recuperar mediante la función MPI_Comm_group . Es el grupo asociado al comunicador inicial MPI_COMM_WORLD.

Requisitos

Producto

Paquete redistribuible DE HPC Pack 2012 MS-MPI, HPC Pack 2008 R2 MS-MPI Redistributable Package, HPC Pack 2008 MS-MPI Redistributable Package o HPC Pack 2008 Client Utilities

Encabezado

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

Archivo DLL

Msmpi.dll

Consulte también

Funciones de grupo de MPI

MPI_Comm_group