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

MSRename

MsRename(cArqOrig,cArqDest) -> lOk

Renomeia um arquivo conforme o RDD corrente.

MSRenameAdvPL
01 · VISÃO GERAL

Visão geral

A referência histórica recebe origem e destino com nome e extensão e retorna lógico de sucesso. Não é renomeação de alias aberto nem alteração do nome lógico no dicionário. O escopo de caminhos e as restrições dependem do RDD e do ambiente. A documentação histórica não comprova suporte irrestrito a renomeação de tabelas em todos os SGBDs. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

MsRename(cArqOrig,cArqDest) -> lOk

Parâmetros

cArqOrig
CaractereObrigatório

Arquivo de origem, com extensão.

cArqDest
CaractereObrigatório

Novo nome, com extensão.

Retorno

Lógico: .T. se a operação tiver sucesso.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed550()
    // Bloco nao invocado; usar somente arquivos de teste proprios e fechados.
    Local bRenomear := {|cOrigem,cDestino| MsRename(cOrigem,cDestino)}
    ConOut(ValType(bRenomear))
Return Nil
Resultado esperado

Imprime B. A renomeação não é executada. Em revisão: exemplo editorial não compilado nem executado em Protheus. Conferir includes, release, RDD e contexto antes de homologar.

BOAS PRÁTICAS
  • Confirmar origem, destino livre, permissões, RDD e dependências de índices antes de avaliar. Tratar falha sem assumir que o destino foi criado.
  • 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. 360. 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