Usina BRAdvPL Guia
Entrar
← Todos os tópicos
FUNçãOEm revisão

MSAppend

MsAppend([cArqDest],cArqOrig) -> lOk

Acrescenta registros de uma origem à tabela de destino.

MSAppendAdvPL
01 · VISÃO GERAL

Visão geral

Exige estruturas compatíveis. No acesso DBFCDX, o destino omitido usa a área corrente; no TOP o destino deve ser informado. Não é cópia binária de arquivo. Referência histórica: confirmar comportamento no release/RDD utilizado. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsAppend([cArqDest],cArqOrig) -> lOk

Parâmetros

cArqDest
CaractereOpcional

Destino; obrigatório no TOP.

cArqOrig
CaractereObrigatório

Origem dos registros.

Retorno

Lógico indicando o resultado da operação descrita.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed533()
    // Bloco nao invocado; fornecer somente artefatos de teste autorizados.
    Local bOperacao := {|cOrigem,cDestino| MsAppend(cDestino,cOrigem)}
    ConOut(ValType(bOperacao))
Return Nil
Resultado esperado

Imprime B. A operação não é executada; ao integrar, conferir o retorno lógico. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Conferir RDD, conexão, caminho e propriedade do destino. Tratar falhas, colisões e recursos abertos. Não usar este fragmento como backup ou migração de produção.
  • Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

Conteúdos relacionados

REFERÊNCIAS
  1. Waterloo Ferreira da Silva. AdvPL — O Manual, versão 1.0, p. 356. Referência histórica. Consulta em 2026-10-27.
Situação
Em revisão
Página criada em
Última revisão em
Idioma original
Português
Revisão
Usina.BR
0 comentário(s) aprovado(s)

Comentários

Ainda não há comentários aprovados.

Entre com Google ou Microsoft para comentar.

Powered by Usina Docs · Alpha