Funções runtime de cadeia de caracteres de X++

Este artigo descreve as funções de tempo de execução da cadeia de caracteres.

fósforo

Pesquisa uma cadeia de caracteres ou expressão em outra cadeia de caracteres.

int match(str pattern, str text)

Parâmetros

Valor de retorno

1 se o padrão estiver localizado na cadeia de caracteres; caso contrário, 0 (zero).

Observações

A pesquisa não diferencia maiúsculas de minúsculas. Os caracteres especiais a seguir podem ser usados para criar o padrão para o parâmetro padrão .

• \: uma barra invertida (\) nullifies, ou escapes, o tratamento especial de caracteres especiais, para que um caractere especial possa ser correspondido como uma letra normal. Um par de barras invertidas é traduzido em uma barra invertida não racial. Exemplos:

  • match("ab$cd","ab$cd"); retorna 0.
  • match("ab\$cd","ab$cd"); retorna 0. A barra invertida não escapou.
  • match("ab\\$cd","ab$cd"); retorna 1. A barra invertida e o sinal de dólar escapam.

• < ou ^: um colchete de ângulo esquerdo (<) ou um circunflexo (^) no início de uma expressão é usado para corresponder ao início de uma linha. Exemplos:

  • match("<abc","abcdef"); retorna 1.
  • match("<abc","defabc"); retorna 0.
  • match("^abc","abcdef"); retorna 1.
  • match("^abc","defabc"); retorna 0.

• > ou $: um colchete de ângulo reto (>) ou um sinal de dólar ($) no final da expressão é usado para corresponder ao final de uma linha. Exemplos:

  • match("abc>","abcdef"); retorna 0.
  • match("abc>","defabc"); retorna 1.

• ? ou.: um ponto de interrogação (?) ou um período (.) corresponde a qualquer caractere na mesma posição. Exemplos:

  • match("abc.def","abc#def"); retorna 1.
  • match("colou?r","colouXr"); retorna 1.

• :x: dois-pontos (:) especifica um grupo de caracteres a serem correspondidos, conforme indicado pelo caractere que segue imediatamente.

• :a: Define a correspondência como letras. Exemplos:

  • match("ab:acd","ab#cd"); retorna 0.
  • match("ab:acd","abxyzcd"); retorna 0.
  • match("ab:acd","abxcd"); retorna 1.

• :d: define a correspondência como caracteres numéricos. Exemplos:

  • match("ab:dcd","ab3cd"); retorna 1.
  • match("ab:dcd","ab123cd"); retorna 0.
  • match("ab:dcd","abcd"); retorna 0.

• :n: define a correspondência como caracteres alfanuméricos. Exemplos:

  • match("ab:ncd","ab%cd"); retorna 0.
  • match("ab:ncd","ab9cd"); retorna 1.
  • match("ab:ncd","abXcd"); retorna 1.

• :SPACE: SPACE é o caractere de espaço (" "). Define a correspondência como espaços em branco, tabulações e caracteres de controle, como Enter (nova linha). Exemplos:

  • match("ab: cd","ab cd"); retorna 1.
  • match("ab: cd","ab\ncd"); retorna 1.
  • match("ab: cd","ab\tcd"); retorna 1.
  • match("ab: cd","ab cd"); retorna 0. Somente o primeiro espaço é correspondido.

• *: uma expressão seguida por um asterisco ("*") requer uma correspondência para zero, uma ou mais ocorrências da expressão anterior. Exemplos:

  • match("abc*d","abd"); retorna 1.
  • match("abc*d","abcd"); retorna 1.
  • match("abc*d","abcccd"); retorna 1.
  • match("abc*d","abxd"); retorna 0.

• +: uma expressão seguida por um sinal de adição (+) requer uma correspondência para uma ou mais ocorrências da expressão anterior. Exemplos:

  • match("abc+d","abd"); retorna 0.
  • match("abc+d","abcd"); retorna 1
  • match("abc+d","abcccd"); retorna 1.
  • match("abc+d","abxd"); retorna 0.

• -: uma expressão seguida por um sinal de subtração (-) requer uma correspondência para zero ou uma ocorrência da expressão anterior. Em outras palavras, a expressão anterior é opcional. Exemplos:

  • match("colou-r","color"); retorna 1.
  • match("colou-r","color"); retorna 1.

• []: corresponde a um único caractere com qualquer caractere que esteja entre colchetes. Um intervalo de caracteres pode ser especificado por dois caracteres separados por um sinal de menos (-). Por exemplo, [a-z] corresponde a todas as letras entre a e z, [0-9] corresponde a um dígito e [0-9a-f] corresponde a um dígito hexadecimal. Exemplos:

  • match("[abc]","apple"); retorna 1, porque corresponde a um em "apple".
  • match("[abc]","kiwi"); retorna 0, porque "kiwi" não contém um a, b ou c.
  • match("gr[ae]y","grey"); retorna 1. Essa expressão também corresponde a "cinza".
  • match("gr[ae]y","graey"); retorna 0, porque apenas um caractere entre "gr" e "y" é correspondido.

• [^]: se o primeiro caractere no texto que está entre colchetes for circunflexo (^), a expressão corresponderá a todos os caracteres, exceto os caracteres que estão entre colchetes. Exemplos:

  • match("[^bc]at","bat"); retorna 0.
  • match("[^bc]at","hat"); retorna 1.
  • match("[^abc]","bat"); retorna 1. Qualquer coisa, exceto um, b ou c é correspondido. Portanto, o t é correspondido.

strAlpha

Copia apenas os caracteres alfanuméricos de uma cadeia de caracteres.

str strAlpha(str _text)

Parâmetros

Valor de retorno

Uma nova cadeia de caracteres que contém todos os caracteres alfanuméricos da cadeia de caracteres especificada.

Observações

Por exemplo, strAlpha("2+2=5 está correto?") retorna a cadeia de caracteres 225isthiscorrect.

Example

static void strAlphaExample(Args _arg)
{
    str s;
    ;
    s = strAlpha("?a*bc123.");
    print s;
    pause;
}

strCmp

Compara duas cadeias de caracteres de texto.

int strCmp(str text1, str text2)

Parâmetros

Valor de retorno

0 se as duas cadeias de caracteres forem idênticas, 1 se a primeira cadeia de caracteres classificar anteriormente ou -1 se a segunda cadeia de caracteres for classificada anteriormente.

Observações

A comparação executada por esse método diferencia maiúsculas de minúsculas.

print strCmp("abc", "abc"); //Returns the value 0.
print strCmp("abc", "ABC"); //Returns the value 1.
print strCmp("aaa", "bbb"); //Returns the value -1.
print strCmp("ccc", "bbb"); //Returns the value 1.

strColSeq

Converte todos os caracteres maiúsculos em caracteres minúsculos e converte todos os caracteres que têm ênfases nos caracteres minúsculos não localizados correspondentes.

str strColSeq(str text)

Parâmetros

Valor de retorno

A cadeia de caracteres de texto convertida.

Observações

A função strColSeq existe para fins de compatibilidade com versões anteriores. Essa função dá suporte apenas ao mapeamento para os seguintes caracteres da Europa Ocidental:

• AàáâãäÀÁÂÃÄBCçÇDEèéêëÈÉËËFGHIìíîïÌÍÎÏJKLMNñÑOòóôõöÒÓÔÕÖPQRSTUùúùúÙÜVWXYýÝZæøåØØÅ
• aaaaaaaaaaaabcccdeeeeeeeeefghiiiiiiiiijklmnnnooooooooopqrstuuvwxyyz~>Ç~\Ç

Para funcionalidades compatíveis com Unicode, use a API (interface de programação de aplicativo) win32 LCMapString por meio das classes DLL e DLLFunc .

Example

O exemplo a seguir imprime abcdeabcde.

    static void strColSeqExample(Args _arg)
    {
            ;
            print strColSeq("");
            pause;
    }

strDel

Cria uma cópia de uma cadeia de caracteres, da qual a subcadeia de caracteres especificada é removida.

str strDel(str _text, int _position, int _number)

Parâmetros

Valor de retorno

Os caracteres restantes que são copiados da cadeia de caracteres.

Observações

A função strDel é complementar à função substr .

strDel("ABCDEFGH",2,3); //Returns the string "AEFGH".
strDel("ABCDEFGH",4,3); //Returns the string "ABCGH".

strFind

Pesquisa uma cadeia de caracteres para a primeira ocorrência de um dos caracteres especificados.

int strFind(str _text, str _characters, int _position, int _number)

Parâmetros

Valor de retorno

O valor da posição da primeira ocorrência de um dos caracteres especificados ou 0 quando nenhum encontrado.

Observações

Para pesquisar do início da cadeia de caracteres até o final, use 1 como o valor do parâmetro _position . Se o valor do parâmetro _number for negativo, o sistema pesquisará o número de caracteres para trás da posição especificada. A pesquisa não é sensível a maiúsculas e minúsculas. Veja um exemplo.

strFind("ABCDEFGHIJ","KHD",1,10); //Returns the value 4 (the position where "D" was found).
strFind("ABCDEFGHIJ","KHD",10,-10); //Returns the value 8 (the position where "H" was found).

A função strFind é complementar à função strNFind .

strFmt

Formata a cadeia de caracteres especificada e substitui todas as ocorrências de n pelo argumento nth.

str strFmt(str _string, ...)

Parâmetros

Valor de retorno

A cadeia de caracteres formatada.

Observações

Se um argumento não for fornecido para um parâmetro, o parâmetro retornará como "%n" na cadeia de caracteres. A conversão de cadeia de caracteres de valores do tipo real é limitada a duas casas decimais . Os valores são arredondados, não truncados. O método System.String::Format do Microsoft .NET Framework pode ser usado para obter mais funcionalidade, conforme mostrado no exemplo.

Example

static void strFmtExampleJob(Args _arg)
{
    System.Double sysDouble;
    real r = 8.3456789;
    int  i = 42;
    utcDateTime utc = str2DateTime("2008-01-16 13:44:55" ,321); // 321 == YMD.
    str  s;
    ;
    s = strFmt("real = %1, int = %2, utcDateTime = %3, [%4]", r, i, utc);
    info("X1:  " + s);
    //
    sysDouble = r;
    s = System.String::Format("{0:##.####}", sysDouble);
    info("N1:  " + s);
    //
    s = System.String::Format("{0,6:C}", sysDouble); // $
    info("N2:  " + s);
    /**********  Actual Infolog output
    Message (02:16:05 pm)
    X1:  real = 8.35, int = 42, utcDateTime = 1/16/2008 01:44:55 pm, [%4]
    N1:  8.3457
    N2:   $8.35
    **********/
}

strIns

Cria uma cadeia de caracteres inserindo uma cadeia de caracteres em outra.

str strIns(str _text1, str _text2, int _position)

Parâmetros

Valor de retorno

A cadeia de caracteres de texto combinada.

Observações

A função strIns é complementar à função strDel . Se o valor do parâmetro _position for maior que o comprimento da cadeia de caracteres original, a cadeia de caracteres a ser inserida será acrescentada ao final da cadeia de caracteres original.

strIns("ABFGH","CDE",3); //Returns the string "ABCDEFGH".
strIns("ABCD","EFGH",10); //Returns the string "ABCDEFGH".

strKeep

Cria uma cadeia de caracteres usando apenas os caracteres da primeira cadeia de caracteres de entrada especificada pela segunda cadeia de caracteres de entrada.

str strKeep(str _text1, str _text2)

Parâmetros

Valor de retorno

Uma cadeia de caracteres dos caracteres que são mantidos.

Observações

strKeep("ABBCDDEFGHB","BCD"); //Returns the string "BBCDDB".
strKeep("abcZcba","bc") //Returns the string "bccb".

A função strKeep é complementar à função strRem .

strLen

Calcula o comprimento da cadeia de caracteres especificada.

int strLen(str text)

Parâmetros

Valor de retorno

O comprimento da cadeia de caracteres especificada.

Observações

strLen("ABC"); //Returns the value 3.
strLen("ABCDEFGHIJ"); //Returns the value 10.

strLine

Recupera uma única linha de uma cadeia de caracteres que abrange várias linhas.

str strLine(str string, int count)

Parâmetros

Valor de retorno

Uma linha copiada da cadeia de caracteres especificada pelo parâmetro de cadeia de caracteres .

Observações

A primeira linha da cadeia de caracteres tem um deslocamento de 0. Você pode atribuir várias linhas a uma cadeia de caracteres inserindo os caracteres\n ou \r\n na cadeia de caracteres. Além disso, você pode usar o sinal no sinal (@) imediatamente antes da aspa de abertura e usar a tecla Enter para espalhar partes do valor da cadeia de caracteres em várias linhas no editor de código X++.

Example

str mytxt = "first-line\nsecond-line\nlast-line";
// Prints "second-line".
print strLine(mytxt,1);
// Prints "last-line".
print strLine(mytxt,2);            

strLTrim

Remove os espaços em branco à esquerda de uma cadeia de caracteres de texto.

str strLTrim(str text)

Parâmetros

Valor de retorno

O equivalente de cadeia de caracteres para o texto do qual os espaços em branco à esquerda foram removidos.

Observações

A função strLTrim é complementar à função strRTrim .

Example

// Returns the text string "ABC-DEFG".
strLTrim("   ABC-DEFG");

strLwr

Converte todas as letras na cadeia de caracteres especificada em minúsculas.

str strLwr(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que contém apenas letra minúscula.

Observações

A função strLwr é complementar à função strUpr . A função strLwr usa a função LCMapString na API Win32.

Example

static void strLwrExample(Args _args)
{
    // Returns the text string "abcdd55efghij".
    print strLwr("Abcdd55EFGHIJ");
    pause;
}

strNFind

Pesquisa parte de uma cadeia de caracteres de texto para a primeira ocorrência de um caractere que não está incluído na lista especificada de caracteres.

int strNFind(str _text, str _characters, int _position, int _number)

Parâmetros

Valor de retorno

A posição da primeira ocorrência de um caractere que não é especificado pelo parâmetro _characters ou 0 quando nenhum encontrado.

Observações

A pesquisa não é sensível a maiúsculas e minúsculas. Para pesquisar do início da cadeia de caracteres até o final, use um valor de 1 para o parâmetro _position . Se um sinal de menos preceder o valor do parâmetro _number , os caracteres serão pesquisados em ordem inversa, começando pela posição especificada pelo parâmetro _position .

strNFind("ABCDEFGHIJ","ABCDHIJ",1,10); //Returns the value 5 (the position of "E");
strNFind("CDEFGHIJ","CDEFGIJ",10,-10); //Returns the value 6 (the position of "H").
strNFind("abcdef","abCdef",3,2) //Returns the value 0.
strNFind("abcdef", "abcef",3,2) //Returns the value 4.

A função strNFind é complementar à função strFind .

strPoke

Substitui parte de uma cadeia de caracteres com outra cadeia de caracteres.

str strPoke(str _text1, str _text2, int _position)

Parâmetros

Valor de retorno

A nova cadeia de caracteres.

Observações

A nova cadeia de caracteres pode ser maior que a cadeia de caracteres original. No entanto, se o valor do parâmetro _position for maior que o comprimento da cadeia de caracteres, a cadeia de caracteres original será retornada sem substituições.

strPoke("12345678","AAA",3); //Returns the string "12AAA678".
strPoke("abcde","4567",4); //Returns the string "abc4567".
strPoke("abcde", "4567", "10"); //Returns the string "abcde".

strPrompt

Acrescenta uma cadeia de caracteres com o número especificado de caracteres de período, seguido por dois-pontos e um caractere de espaço.

str strPrompt(str _string, _int len)

Parâmetros

Valor de retorno

Uma cadeia de caracteres que se parece com um prompt de entrada do usuário.

Observações

Em casos atípicos, em que o valor do parâmetro _len é apenas um pouco mais do que o comprimento da cadeia de caracteres original, a precedência mais alta é dada para adicionar o espaço à direita. Em seguida, a precedência é dada aos dois-pontos. A precedência mais baixa é dada aos períodos. Valores negativos para o parâmetro _len retornam a cadeia de caracteres de entrada acrescentada com um espaço à direita.

strPrompt("ab",-1); //Returns "ab ".
strPrompt("ab",3); //Returns "ab ".
strPrompt("ab",4); //Returns "ab: ".
strPrompt("ab",5); //Returns "ab.: ".
strPrompt("ab",6); //Returns "ab..: ".

Example

static void JobStrPromptDemo(Args _args)
{
    // Printed string is "[abc..: ]"
    print "[", strPrompt("abc", 7), "]";
    pause;
}

strRem

Remove os caracteres especificados em uma cadeia de caracteres de outra cadeia de caracteres.

str strRem(str text1, str text2)

Parâmetros

Valor de retorno

O conteúdo restante da cadeia de caracteres original.

Observações

Essa função diferencia maiúsculas de minúsculas.

strRem("abcd_abcd","Bc"); //Returns the string "abd_abd".
strRem("ABCDEFGABCDEFG","ACEG"); //Returns the string "BDFBDF".

Essa função é complementar à função strKeep .

strRep

Repete uma cadeia de caracteres.

str strRep(str _text, str _number)

Parâmetros

Valor de retorno

Uma nova cadeia de caracteres que contém o conteúdo da cadeia de caracteres original que repetiu o número especificado de vezes.

Example

O exemplo a seguir imprime a cadeia de caracteres de texto ABABABABABAB.

static void strRepExample(Args _arg)
{
    str strL;
    ;
    strL = strRep("AB",6);
    print strL;
    pause;
}

strRTrim

Remove os caracteres de espaço à direita do final de uma cadeia de caracteres.

str strRTrim(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que não inclui caracteres de espaço à direita.

Observações

strRTrim("ABC-DEFG- "); //Returns the string "ABC-DEFG-".
strRTrim(" CD "); //Returns " CD".

A função strRTrim é complementar à função strLTrim .

strScan

Pesquisa uma cadeia de caracteres de texto em busca de uma ocorrência de outra cadeia de caracteres.

int strScan(str _text1, str _text2, int _position, int _number)

Parâmetros

Valor de retorno

A posição na qual a cadeia de caracteres especificada foi encontrada na cadeia de caracteres; caso contrário, 0 (zero).

Observações

As comparações não diferenciam maiúsculas de minúsculas. Os valores do parâmetro _position menores que 1 são tratados como 1. A direção da verificação é controlada pelo sinal especificado no parâmetro _number . Um sinal positivo indica que cada comparação sucessiva inicia uma posição mais próxima do final da cadeia de caracteres. Um sinal negativo indica que cada comparação inicia uma posição mais próxima do início da cadeia de caracteres.

strScan("ABCDEFGHIJ","DEF",1,10); //Returns the value 4.
strScan ("ABCDEFGHIJ","CDE",10,-10); //Returns the value 3.

strUpr

Converte todas as letras em uma cadeia de caracteres em maiúsculas.

str strUpr(str _text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que contém apenas letras minúsculas.

Observações

A função strUpr é complementar à função strLwr . A função strUpr usa a função LCMapString() na API Win32.

Example

O exemplo a seguir imprime ABCDD55EFGHIJ.

static void strUprExample(Args _args)
{
    print strUpr("Abcdd55EFGhiJ");
    pause;
}

subStr

Recupera parte de uma cadeia de caracteres.

str subStr(str _text, int _position, int _number)

Parâmetros

Valor de retorno

Uma subcadeia de caracteres da cadeia de caracteres original.

Observações

Se um sinal de subtração preceder o valor do parâmetro _number , a subcadeia de caracteres será selecionada para trás da posição especificada.

subStr("ABCDEFGHIJ",3,5); //Returns the string "CDEFG".
subStr("ABCDEFGHIJ",7,-4); //Returns the string "DEFG".
subStr("abcdef",2,99) //Returns the string "bcdef".
subStr("abcdef",2,3) //Returns the string "bcd".
subStr("abcdef",2,-3); //Returns the string "ab".

strContains

Verifica se a cadeia de caracteres de texto contém outra cadeia de caracteres.

boolean strContains(str _text, str _potentialContains)

Parâmetros

Valor de retorno

True se a cadeia de caracteres original contiver a cadeia de caracteres pesquisada; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

strContains("ABCDEFGHIJ","abc"); //Returns true.
strContains("ABCDEFGHIJ","ABC"); //Returns true.
strContains("ABCDEFGHIJ","K"); //Returns false.

strStartsWith

Verifica se a cadeia de caracteres de texto começa com outra cadeia de caracteres.

boolean strStartsWith(str _string, str _potentialStart)

Parâmetros

Valor de retorno

True se a cadeia de caracteres potencial for o início da cadeia de caracteres original; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

strStartsWith("ABCDEFGHIJ","abc"); //Returns true.
strStartsWith("ABCDEFGHIJ","ABC"); //Returns true.
strStartsWith("ABCDEFGHIJ","B"); //Returns false.

strEndsWith

Verifica se a cadeia de caracteres de texto termina com outra cadeia de caracteres.

boolean strEndsWith(str _string, str _potentialEnd)

Parâmetros

Valor de retorno

True se a cadeia de caracteres potencial estiver encerrando a cadeia de caracteres original; caso contrário, false.

Observações

As comparações não diferenciam maiúsculas de minúsculas.

strEndsWith("ABCDEFGHIJ","ghij"); //Returns true.
strEndsWith("ABCDEFGHIJ","HIJ"); //Returns true.
strEndsWith("ABCDEFGHIJ","B"); //Returns false.

strLRTrim

Remove os espaços em branco à esquerda e à parte traseira de uma cadeia de caracteres de texto.

str strLRTrim(str text)

Parâmetros

Valor de retorno

Uma cópia da cadeia de caracteres especificada que não inclui caracteres de espaço à esquerda e à direita.

Observações

A função strLRTrim é complementar às funções strRTrim e strLTrim .

Example

// Returns the text string "ABC-DEFG".
strLRTrim("   ABC-DEFG   ");