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

SortArray / ScanArray

SortArray(aArray,[nStart],[nCount],[lAscending],nColumn); ScanArray(aArray,xValue,[nStart],[nCount],nColumn)

Ordena e pesquisa arrays na referência eAdvPL histórica.

SortArray / ScanArrayAdvPL
01 · VISÃO GERAL

Visão geral

SortArray recebe faixa, direção lógica e coluna; ScanArray recebe expressão, faixa e coluna e documenta posição ou zero. O guia contém erros: o retorno de SortArray repete texto de pesquisa e a seção aSize imprime ScanArray no lugar do nome. Por isso não atribuímos um retorno a SortArray nem extrapolamos semântica de comparação. O bloco demonstra somente ScanArray com coluna explícita e não é invocado. Para código AdvPL atual, conferir ASort e AScan separadamente. (Fontes: refs. 1–1.)

02 · SINTAXE

Sintaxe

SortArray(aArray,[nStart],[nCount],[lAscending],nColumn); ScanArray(aArray,xValue,[nStart],[nCount],nColumn)

Retorno

ScanArray: posição ou zero; retorno de SortArray inconsistente na fonte.

03 · EXEMPLO PRÁTICO

Exemplo comentado

#Include "Protheus.ch"

User Function Ed669()
    // Referencia eAdvPL; nao confundir com AScan atual.
    Local bPesquisar := {|aLinhas| ScanArray(aLinhas,"A",1,Len(aLinhas),1)}
    ConOut(ValType(bPesquisar))
Return Nil
Resultado esperado

Cria bloco B; não ordena nem pesquisa um array nesta execução. 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 plataforma e tratar zero antes de indexar. Testar lista vazia, faixa parcial e formatos de linha.
  • 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. Guia de referência eAdvPL. §7.2–7.4. Inconsistências identificadas no texto histórico. Consulta em 2026-10-28.
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