nginstack

Module: @nginstack/engine/lib/string/stringCompare

(require("@nginstack/engine/lib/string/stringCompare"))(referenceStr, compareStr)

Retorna um número inteiro indicando se referenceStr vem antes, depois ou se é equivalente a compareStr em uma ordenação de texto ignorando acentos e diferenças entre letras maiúsculas e minúsculas.

Para fins de comparação, valores nulos são considerados equivalentes a uma string vazia.

Esta função utiliza a mesma regra de comparação de campos do tipo string do DataSet, sendo apropriada para navegar sobre registros ordenados com valores repetidos.

Esta função também é publicada como ngin.text.compare() no escopo global e é uma alternativa compatível com runtime V8 ao método String.prototype.compare() implementado no runtime Ije.

Parameters:
Name Type Description
referenceStr string

String que será comparada.
compareStr string

String contra a qual referenceStr será comparada.
Returns:

Será retornado um número negativo se referenceStr vier antes de compareStr, positivo se vier depois e zero se forem equivalentes.

Type
number
Examples
const stringCompare = require('@nginstack/engine/lib/string/stringCompare');
const keys = [];
ds.indexFieldNames = 'iName;'
if (ds.find(value)) {
  while (!ds.eof; stringCompare(ds.str('iName'), value)) {
    keys.push(ds.dbkey('iKey'));
    ds.next();
  }
}
const stringCompare = require('@nginstack/engine/lib/string/stringCompare');
stringCompare('A', 'Á'); // => 0
stringCompare('A', 'a'); // => 0
stringCompare('test', 'TEST'); // => 0
stringCompare('Abc', 'Abcd'); // => negative value
stringCompare('Def', 'Abc'); // => positive value