Manipulação da Cadeia

Voltar para Página Principal


$Quote

Descrição

Essa instrução insere o caractere '.

Sintaxe

FUNCTION $Quote: '''';

BooleanFormat

Descrição

Inspeciona a altera o formato de exibição de valores Booleanos.

Sintaxe

FUNCTION BooleanFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Quando fornecido, esse argumento substitui o formato padrão

Notas

Essa função inspeciona e altera o formato padrão utilizado sempre que um valor desse tipo é convertido para o formato de texto.

Se for chamado sem argumentos, BooleanFormat retorna o formato de exibição Booleano padrão existente. Se for fornecido argumento, esse valor substitui o padrão atual e o formato antigo é retornado.

Consulte a seção Notas da instrução WinWrite para obter uma explicação dos formatos de exibição.

Exemplo

 VARIABLES
 oldFormat: INTEGER;
ACTIONS
 oldFormat:= BooleanFormat(BitOr($FmtBoolYesNo, $FmtLeftJustify));
 ...
 BooleanFormat(oldFormat);
              END;

Consulte também


Char

Descrição

Converte um código de caractere ASCII (valor de ponto de código) em uma cadeia de um caractere. A aparência real dessa cadeia pode variar, dependendo da página de códigos ativa atualmente. Para obter informações sobre páginas de códigos, consulte a documentação do sistema operacional.

Sintaxe

FUNCTION Char (VAL code: INTEGER): STRING;

Notas do Argumento

Nome do Argumento Descrição
code Inteiro que representa um valor ASCII

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=Char(255);

Consulte também

CharCode


CharCode

Descrição

Retorna o código de caractere ASCII (valor do ponto de código) do primeiro caractere de uma cadeia. O valor numérico do ponto de código retornado para uma determinada representação de caractere pode variar, dependendo da página de código selecionada atualmente. Para obter informações sobre páginas de códigos, consulte a documentação do sistema operacional.

Sintaxe

FUNCTION CharCode (VAL str: STRING): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
str Corresponde a qualquer cadeia

Notas

O argumento str é tratado como uma cadeia de um caractere. Se você inserir uma cadeia de vários caracteres, é retornado o código de caracteres ASCII do primeiro caractere da cadeia.

Exemplo

i := CharCode('A'); (* i = 65 *)

Consulte também

Char


IntegerFormat

Descrição

Inspeciona e altera o formato de texto de valores inteiros.

Sintaxe

FUNCTION IntegerFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Quando fornecido, esse argumento substitui o formato padrão

Notas

Essa função inspeciona e altera o formato padrão utilizado sempre que um valor desse tipo é convertido para o formato de texto.

Se for chamado sem argumentos, IntegerFormat retorna o padrão. Se for fornecido um argumento, esse valor substitui o padrão atual e o padrão anterior é retornado.

Exemplo

 VARIABLES
oldFormat: INTEGER;
ACTIONS
oldFormat := IntegerFormat(BitOr(IntegerFormat, $FmtIntSigned));
 -- Prepend the sign to all integers.
 ...
 IntegerFormat(oldFormat);
              END;

Códigos de Retorno

IntegerFormat não retorna códigos. Como o valor retornado por StringFormat, o valor retornado por IntegerFormat é o valor anterior da matriz de bits do sinalizador de formato. O valor pode ser tratado como um inteiro, pois o TSD Script não contém um tipo de matriz de bits. O sinal do valor não é significativo.

Consulte também

Para obter uma explicação sobre formatos de exibição, consulte Sinalizadores de Formato de Tipo de Dados.


RealFormat

Descrição

Inspeciona ou altera o formato do texto padrão para valores reais.

Sintaxe

FUNCTION RealFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Quando fornecido, esse argumento substitui o formato padrão

Notas

Essa função inspeciona ou altera o formato padrão utilizado sempre que um valor desse tipo está sendo convertido para o formato de texto. Se for chamado sem argumentos, retorna o padrão existente. Se for fornecido um argumento, esse valor torna-se o padrão. O padrão original é retornado.

Exemplo

CONSTANTS
 sigDigits IS 2; -- Two digits to the right of the decimal.
 VARIABLES
 oldFormat: INTEGER;
ACTIONS
 oldFormat := RealFormat(BitOr($FmtRealGroupedWithComma, sigDigits));
 ...
 RealFormat(oldFormat);
              END;

Códigos de Retorno

Código de Retorno Descrição
Qualquer O formato real atual se não foram especificados argumentos; o formato real antigo se foi fornecido um argumento.

Consulte também

Para obter mais informações, consulte Sinalizadores de Formato do Tipo de Dados.


StrCopy

Descrição

Retorna uma subcadeia de uma expressão de cadeia.

Sintaxe

FUNCTION StrCopy (VAL source: STRING, VAL start [, length]: INTEGER): STRING;

Notas do Argumento

Nome do Argumento Descrição
source A expressão da cadeia de onde uma subcadeia deve ser copiada.
start O índice baseado em 1 do primeiro caractere a ser copiado. Se o valor inicial for menor que 1, StrCopy falha e retorna um valor desconhecido. Se o valor inicial for maior que o comprimento da cadeia, StrCopy retorna uma cadeia vazia.
length O número de caracteres a serem copiados para a nova cadeia. Se length for menor que 0, StrCopy retorna $Unknown. Se length for maior que os caracteres disponíveis, todos os caracteres disponíveis são copiados.

Notas

StrCopy copia caracteres do comprimento da cadeia de origem e os retorna. A cópia começa com o caractere na posição de início. Se a posição de início for maior que o número de caracteres da cadeia, é retornada uma cadeia vazia.

Exemplo

 VARIABLES
drive,path,fileName: STRING;
ACTIONS
drive:=StrCopy('F:\ADVISOR\DATA\LOCATION.FLD',1,2);
(* drive = 'F:');
path:=StrCopy('F:\ADVISOR\DATA\LOCATION.FLD',3,13);
(* path = '\ADVISOR\DATA'):
fileName:=StrCopy('F:\ADVISOR\DATA\LOCATION.FLD',17,12);
(* fileName = 'LOCATION.FLD' *)

StrDecrypt

Descrição

Decripta uma cadeia criptografada por StrEncrypt com o valor chave fornecido.

Sintaxe

FUNCTION StrDecrypt (VAL Source: STRING, VAL Key: INTEGER): STRING; 

Cuidado: Cadeias incorretas retornam passagens chave inteiras incorretas para StrDecrypt.

Notas do Argumento

Nome do Argumento Descrição
Source A cadeia criptografada anteriormente com uma chamada para StrEncrypt
Key Um valor inteiro para ser utilizado como chave secreta ao decriptar a cadeia

Notas

O algoritmo de criptografia de StrDecrypt e StrEncrypt não é particularmente seguro, mas é aceitável para criptografias não críticas.

Exemplo

(*
 Function FCryptReadIn: This funciton reads an
 encrypted string from a file and decrypts it.
*)
FUNCTION FCryptReadIn(VAL Key:Integer, VAL fhdl:FILE):STRING IS
 VARIABLES
 TmpStr: STRING;
ACTIONS
 FReadLn(fhdl, TmpStr);
 $Result:=StrDecrypt(TmpStr,Key);
              END;

Códigos de Retorno

Código de Retorno Descrição
Decrypted String Conclusão bem-sucedida
$Unknown A chamada para StrDecrypt falhou

Consulte também

StrEncrypt


StrDelete

Descrição

Exclui uma subcadeia de uma cadeia.

Sintaxe

FUNCTION StrDelete (VAL source:string,
                    VAL start: Integer,
                    VAL length: Integer):string

Notas do Argumento

Nome do Argumento Descrição
source A cadeia de onde a subcadeia é excluída.
start A localização de onde começar a excluir caracteres. Se o valor inicial for menor que 0, a exclusão falha e é retornado $Unknown. Se o valor inicial for maior que o comprimento, não são excluídos caracteres e a cadeia original é retornada.
length O número de caracteres a serem excluídos. Se length for menor que 0, StrDelete falha e $Unknown é retornado.

Notas

StrDelete retorna uma cópia da cadeia de origem com um intervalo especificado de caracteres removidos. A cadeia de origem não é afetada.

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=StrDelete('F:\ADVISOR\DATA.DAT',1,11);
(* s = 'DATA.DAT' *)

Códigos de Retorno

StrDelete retorna uma cópia da cadeia de entrada com o intervalo especificado de caracteres removidos. Se houver algum tipo de erro nos argumentos de entrada, retorna $Unknown.


StrEncrypt

Descrição

Criptografa uma cadeia para um formato ilegível utilizando uma chave de inteiros.

Sintaxe

FUNCTION StrEncrypt (VAL Source: STRING, VAL Key: INTEGER): STRING;

Notas do Argumento

Nome do Argumento Descrição
Source A cadeia que precisa ser criptografada.
Key Um valor inteiro utilizado como chave secreta para criptografar uma cadeia

Notas

O algoritmo de criptografia de StrDecrypt e StrEncrypt não é particularmente seguro, mas é aceitável para criptografias não críticas.

Exemplo

(* Function FCryptWriteIn: This funciton writes a string to a
 file in an encrypted form.*)
FUNCTION FCryptWriteIn(VAL Str:String,
                       VAL Key:Integer,
                       VAL fhdl:FILE):INTEGER IS
ACTIONS
 $Result:=FWriteLn(fhdl, StrEncrypt(Str,Key));
              END;

Códigos de Retorno

Código de Retorno Descrição
$Unknown A chamada para StrEncrypt falhou

Consulte também

StrDecrypt


StringFormat

Descrição

Inspeciona ou altera as opções padrão de formatação da cadeia.

Sintaxe

FUNCTION StringFormat [ ( VAL format: INTEGER ) ] : INTEGER;

Notas do Argumento

Nome do Argumento Descrição
format Quando fornecido, esse argumento substitui o formato padrão

Notas

Essa função é utilizada para inspecionar e alterar o formato padrão utilizado sempre que um valor desse tipo é convertido para o formato de texto.

Se for chamado sem argumentos, retorna o padrão existente. Se for fornecido um argumento, o valor torna-se o novo padrão. O padrão anterior é retornado.

Exemplo

 VARIABLES
 oldFormat: INTEGER;
ACTIONS
 oldFormat := StringFormat($FmtLeftJustify);
 ...
 StringFormat(oldFormat);
              END;

Códigos de Retorno

StringFormat retorna o valor anterior da matriz de bits de formato da cadeia. Esse valor de retorna pode ser passado de volta para StringFormat posteriormente. Por exemplo:

 oldFormat :=StringFormat (newFormat);
 ...
 --output some strings
 ... StringFormat (oldFormat) ;

Consulte também

Para obter uma explicação sobre formatos de exibição, consulte o Tivoli Service Desk 6.0 Developer's Toolkit - Guia de Programação do Script.


StrInsert

Descrição

Insere uma subcadeia em uma cadeia.

Sintaxe

FUNCTION StrInsert (VAL source, substring: STRING,
 VAL start: INTEGER): STRING;

Notas do Argumento

Nome do Argumento Descrição
source A cadeia onde a subcadeia é inserida.
substring A cadeia a ser inserida na cadeia de origem.
start A localização onde a subcadeia é inserida no destino. Se a localização de início for menor que 1, StrInsert falha e $Unknown é retornado. Se a localização de início for maior que o comprimento da cadeia de destino, a subcadeia é anexada ao fim da cadeia de destino.

Notas

StrInsert insere uma subcadeia em uma cadeia de origem em uma determinada posição. A inserção ocorre de forma que o primeiro caractere da subcadeia inserida termina no índice indicado pela posição.

Nota: A cadeia emendada é retornada como resultado de StrInsert com as cadeias de entrada inalteradas.

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=StrInsert('F:\DATA.TXT','\ADVISOR',3);
(* s = 'F:\ADVISOR\DATA.TXT' *)

Códigos de Retorno

StrInsert retorna uma cópia da cadeia de destino com a subcadeia inserida, a partir do índice indicado. Se for encontrado algum tipo de erro nos argumentos, a instrução retorna $Unknown.


StrLength

Descrição

Retorna o comprimento de uma cadeia.

Sintaxe

FUNCTION StrLength (VAL str: STRING): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
string Uma expressão de cadeia cujo comprimento deve ser calculado

Notas

StrLength retorna um inteiro, indicando o número de caracteres na expressão de entrada. Retorna $Unknown se a cadeia for $Unknown.

Exemplo

 VARIABLES
        i: INTEGER;
path,fileName: STRING;
ACTIONS
path:='F:\EADVISOR';
fileName:='KMLRUN.EXE';
i:=StrLength(path & '\' & fileName);
(* i = 22 *)

Códigos de Retorno

Código de Retorno Descrição
> = 0 Um inteiro que indica o número de caracteres na expressão de entrada
$Unknown Se a cadeia for $Unknown, o valor de retorna também o é

StrLoad

Descrição

Carrega uma cadeia de uma tabela de cadeias em um arquivo .df criado pelo Criador de Interface.

Sintaxe

FUNCTION StrLoad (VAL formspec: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
formspec Uma especificação de forma do formato 'file[res_name]' onde file é o nome de um arquivo .dfc e res_name é o nome do recurso da cadeia na tabela de cadeias.

Notas

Se a cadeia não puder ser encontrada, o resultado da chamada de função é $Unknown.

Exemplo

KNOWLEDGEBASE test;
    ROUTINES
 PROCEDURE Main;
PRIVATE
    ROUTINES
PROCEDURE Main IS
 VARIABLES
 x: STRING;
ACTIONS
 x := StrLoad('test[test_string]');
 WinMessageBox($Desktop, 'Information', $MBOK, 'The string is ' & x);
              END;

StrLower

Descrição

Converte uma cadeia para letras minúsculas.

Sintaxe

FUNCTION StrLower (VAL str: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
str Uma expressão de cadeia

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=StrLower('F:\MYFILE.TXT');
(* s = 'f:\myfile.txt' *)

Códigos de Retorno

StrLower retorna uma cópia da cadeia de entrada onde todos os caracteres maiúsculos foram convertidos em minúsculos. A cadeia de entrada fica inalterada.

Consulte também

StrUpper


StrLTrim

Descrição

Corta espaços iniciais, tabulações e caracteres de avanço de linha de uma cadeia.

Sintaxe

FUNCTION StrLTrim (VAL str: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
str Uma expressão de cadeia

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=StrLTrim('F:\DATA.TXT');
(* s = 'F:\DATA.TXT' *)

Códigos de Retorno

Retorna uma cópia da cadeia de entrada com todos os espaços iniciais, tabulações e caracteres de avanço de linha removidos. A cadeia de entrada não é alterada.

Consulte também

StrTrim


StrMatch

Descrição

Pesquisa um padrão de subcadeia em uma cadeia.

Sintaxe

FUNCTION StrMatch (VAL source, VAL pattern: STRING): BOOLEAN;

Cuidado: A pesquisa não faz distinção entre maiúsculas e minúsculas.

Notas do Argumento

Nome do Argumento Descrição
source Uma expressão da cadeia a ser pesquisada.
pattern Uma expressão de cadeia que contém opcionalmente caracteres curinga como ? e *.

Notas

StrMatch compara a cadeia de origem com o padrão. O padrão pode conter caracteres curinga:

A correspondência não faz distinção entre maiúsculas e minúsculas.

Exemplo

 VARIABLES
f: FILE;
l: LIST OF STRING;
match: LIST OF STRING;
ACTIONS
FOpen(f,'MYFILE.TXT',$Read);
FReadText(f,l);
FClose(f);
FOR l DO
 IF StrMatch(l[$Current],'*printer*') THEN
 ListInsert(match,l[$Current]);
              END;

Códigos de Retorno

StrMatch retorna TRUE se as cadeias origem e padrão correspondem e FALSE caso contrário.


StrPos

Descrição

Encontra a posição de uma subcadeia em uma cadeia.

Sintaxe

FUNCTION StrPos (VAL source, VAL substring: STRING): INTEGER;

Notas do Argumento

Nome do Argumento Descrição
source Uma cadeia que provavelmente contém a subcadeia
Substring Uma cadeia de caracteres na cadeia de origem

Notas

StrPos faz uma varredura sem distinção entre maiúsculas e minúsculas do início da cadeia de entrada até encontrar a cadeia de destino. Se o destino for encontrado, StrPos retorna o índice na cadeia de entrada onde a correspondência ocorreu. Caso contrário, retorna zero.

Exemplo

 VARIABLES
        i: INTEGER;
ACTIONS
i:=StrPos(F:\DATA\MYFILE.DAT','\');
(* i = 3 *)

Códigos de Retorno

Código de Retorno Descrição
0 A subcadeia não foi encontrada
-1 A cadeia de origem é desconhecida
-2 A subcadeia é desconhecida

Consulte também

StrToken


StrReplaceTerms

Descrição

Substitui as designações de termos dentro de uma cadeia de origem pelos valores de terminologia apropriados.

Sintaxe

FUNCTION StrReplaceTerms (VAL source: STRING): STRING; 

Cuidado: Se a variável indicada não existir, ou seu valor não puder ser convertido em uma cadeia, aparece um quadro de aviso e a designação do termo não é substituída na cadeia resultante.

Notas do Argumento

Nome do Argumento Descrição
source Uma cadeia com zero ou mais designações de termo incorporadas.

Notas

Uma designação de termo é uma subcadeia incorporada na forma:

{{KNOWLEDGEBASE:VARIABLE}}

onde KNOWLEDGEBASE é o nome de uma base de informações e VARIABLE é o nome de uma variável declarada no escopo mais externo dessa base de informações. A variável indicada não precisa ser declarada na seção pública da base de informações.

Todas essas formas incorporadas na cadeia de origem são substituídas pelo valor da variável indicada. A cadeia de origem não é modificada por essa função.

Exemplo

msg := StrReplaceTerms(
 'The {{GLOBALS:T_CALLER}} has no open
 {{GLOBALS:T_PROBLEMS}}.');
-- T_CALLER and T_PROBLEMS from GLOBALS.KB contain 'caller'
-- and 'problems' respectively, or synonyms such as 'customer'
-- and 'inquires'.

Códigos de Retorno

StrReplaceTerms retorna a cadeia modificada. Se a cadeia de origem for desconhecida, StrReplaceTerms retorna $Unknown.


StrToken

Descrição

Transforma uma cadeia em símbolos, de forma destrutiva.

Sintaxe

FUNCTION StrToken (REF source: STRING,
                   VAL delimiters: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
source Uma variável de cadeia a ser transformada em símbolos
delimiters Uma cadeia que contém um ou mais caracteres delimitadores

Notas

A função StrToken divide o conjunto de caracteres inteiro em dois subconjuntos desconectados: caracteres membros de símbolos (o conjunto de símbolos) e aqueles que não são membros de símbolos (o conjunto delimitador). Quando você chama StrToken em uma cadeia de origem conhecida, essa instrução faz o seguinte:

Como resultado desse processo, a cadeia de origem torna-se mais curta sempre que essa função é chamada, tornando-se eventualmente uma cadeia vazia. Quando não existirem mais símbolos na cadeia de origem, StrToken retorna a cadeia vazia.

Exemplo

WHILE NOT FEnd (inputFile) DO
 FReadLn (inputFile, inputLine);
 column := 0;
 WHILE (token := StrToken (inputLine,'')) <> ''DO
 ProcessEntry (token, column :=column +1);
              END;
              END;

Códigos de Retorno

Essa função retorna $Unknown se a cadeia de origem ou a cadeia delimitada forem desconhecidas.

Consulte também

StrPos


StrTrim

Descrição

Remove espaço em branco inicial de uma cadeia.

Sintaxe

FUNCTION StrTrim (VAL str: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
str Uma expressão de cadeia

Notas

StrTrim assume uma cadeia como entrada e retorna uma cópia dessa cadeia com todos os espaços em branco iniciais (espaços, tabulações, novas linhas) removidos. A cadeia de entrada não é afetada.

Exemplo

 VARIABLES
f: FILE;
l: LIST OF STRING;
ACTIONS
FOpen(f,'DATA.TXT',$Read);
FReadText(f,l);
FClose(f);
FOR l DO
 l[$Current]:=StrTrim(l[$Current]);

Códigos de Retorno

StrTrim retorna uma cópia de uma cadeia de entrada com todos os espaços em branco iniciais (espaços, tabulações, novas linhas) removidos.

Consulte também

StrLTrim


StrUpper

Descrição

Retorna uma cópia em maiúsculas de uma cadeia.

Sintaxe

FUNCTION StrUpper (VAL str: STRING): STRING;

Notas do Argumento

Nome do Argumento Descrição
str Uma expressão de cadeia

Notas

StrUpper retorna uma cópia da cadeia de entrada com todos os caracteres de letras minúsculas convertidos em maiúsculas. A cadeia de entrada fica inalterada.

Exemplo

 VARIABLES
  s : STRING;
ACTIONS
s:=StrUpper('f:\data\myfile.txt');
(* s = 'F:\DATA\MYFILE.TXT' *)

Códigos de Retorno

StrUpper retorna uma cópia da cadeia de entrada com todos os caracteres de letras minúsculas convertidos em maiúsculas.

Consulte também

StrLower


Tivoli Service Desk 6.0 Developer's Toolkit - Referência da Linguagem de Script

Voltar para Página Principal

Copyright