Compartilhar via


função MPI_Send

Executa uma operação de envio de modo padrão e retorna quando o buffer de envio pode ser reutilizado com segurança.

Sintaxe

int MPIAPI MPI_Send(
  _In_opt_ void         *buf,
           int          count,
           MPI_Datatype datatype,
           int          dest,
           int          tag,
           MPI_Comm     comm
);

Parâmetros

  • buf [in, opcional]
    Um ponteiro para o buffer que contém os dados a serem enviados.

  • contagem
    O número de elementos no buffer. Se a parte de dados da mensagem estiver vazia, defina o parâmetro count como 0.

  • datatype
    O tipo de dados dos elementos no buffer.

  • dest
    A classificação do processo de destino dentro do comunicador especificado pelo parâmetro comm .

  • tag
    A marca de mensagem que pode ser usada para distinguir diferentes tipos de mensagens.

  • comm
    O identificador para o comunicador.

Retornar valor

Retorna MPI_SUCCESS com êxito. Caso contrário, o valor retornado será um código de erro.

No Fortran, o valor retornado é armazenado no parâmetro IERROR .

Fortran

    MPI_SEND(BUF, COUNT, DATATYPE, DEST, TAG, COMM, IERROR)
        <type> BUF(*)
        INTEGER COUNT, DATATYPE, DEST, TAG, COMM, IERROR

Comentários

Essa função não é local. A conclusão bem-sucedida pode depender da existência de uma função de recebimento correspondente.

Essa função pode retornar antes que uma função de recebimento correspondente seja invocada se a implementação do MPI armazenar a mensagem em buffer. No entanto, o espaço em buffer pode estar indisponível ou as mensagens de saída podem não ser armazenadas em buffer por motivos de desempenho. Se a mensagem não estiver armazenada em buffer, a função não retornará até que os dados sejam movidos para o processo de recebimento.

Essa função pode ser chamada se uma função de recebimento correspondente é postada ou não. Ele pode ser concluído antes que uma função de recebimento correspondente seja postada.

Requisitos

Produto

Pacote Redistribuível do HPC Pack 2012 MS-MPI, Pacote Redistribuível HPC Pack 2008 R2 MS-MPI, Pacote Redistribuível do HPC Pack 2008 MS-MPI ou Utilitários de Cliente HPC Pack 2008

parâmetro

Mpi.h; Mpif.h

Biblioteca

Msmpi.lib

DLL

Msmpi.dll

Confira também

Funções ponto a ponto de MPI

MPI_Bsend

MPI_Rsend

MPI_Ssend

MPI_Recv