Es una libreria creada con Microsoft .NET v4.0 y compilada con el nombre JclunaOficial.UString.dll,
el cual contiene funciones para manipular strings con el objetivo reducir el código para evaluar
el estado de una cadena.
Las funciones son publicas (public) y compartidas (static) para que se puedan consumir sin necesidad
de crear una instancia de la clase UString; adicionalmente se pueden accesar a las funciones como
metodos extendidos (extension method) con los tipos de datos string y DateTime.
- Microsoft Visual Studio Community 2015, de preferencia trabajar con la actualización más reciente del IDE.
- Microsoft .NET v4.0+, seguramente incluido en VS2015 pero probablemente se quiera compilar usando la linea de comandos.
- Xamarin Studio, en caso de querer compilar en otra plataforma (Linux o Mac), aunque el compilado con Windows se puede consumir en otras plataformas.
El proyecto esta creado con VS2015 Community y .NET v4.0, pero se pueden copiar los bytes (código) a otros IDEs para compilar y generar la libreria, prosupuesto configurando los ajustes necesarios para tener el producto final.
Si solo quieres la versión compilada de la libreria, entonces la puedes descargar haciendo click aquí. Vas a encontrar todas las versiones que se han generado (Release y Debug); recomiendo uses la más reciente.
En el siguiente bloque de código se muestra el como se trabaja con las funciones en modo extension method; pero también se pueden ejecutar como funciones estaticas de la siguiente forma: UString.Clean()
using JclunaOficial; // importar el namespace
using System;
namespace MyApplication
{
class Program
{
static void Main(string[] args)
{
// limpiar un string con valor nulo (null/nothing)
string stringDummy = null;
Console.WriteLine(stringDummy.Clean());
// > resultado: string.Empty
// asignar valor al string dummy para las siguientes pruebas
stringDummy = " string con eSpacios inTermedios ";
Console.WriteLine("limpiar el string de forma simple");
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy.Clean());
// > resultado: 'string con eSpacios inTermedios'
Console.WriteLine("limpiar el string y truncandolo a 15 caracteres");
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy.Clean(15));
// > resultado: 'string con e'
Console.WriteLine("limpiar, truncar y convertir a mayúsculas");
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy.Upper(22));
// > resultado: 'STRING CON ESPACIOS'
Console.WriteLine("limpiar, truncar y convertir a minúsculas");
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy.Lower(8));
// > resultado: 'string '
Console.WriteLine("limpiar y quitar espacios intermedios");
stringDummy = stringDummy.SingleSpace();
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy);
// > resultado: 'string con eSpacios inTermedios'
Console.WriteLine("codificar a Base64");
stringDummy = stringDummy.Base64Convert();
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy);
// > resultado: 'c3RyaW5nIGNvbiBlU3BhY2lvcyBpblRlcm1lZGlvcw=='
Console.WriteLine("decodificar de Base64 y convertir a minúsculas");
stringDummy = stringDummy.Base64Extract();
Console.WriteLine("> resultado: '{0}'\r\n", stringDummy.Lower());
// > resultado: 'string con espacios intermedios'
var dateDummy = DateTime.Now;
Console.WriteLine("convertir {0} a string con formato ISO-8859-1", dateDummy);
Console.WriteLine("> resultado: '{0}'\r\n", dateDummy.DateTo());
// > resultado: '2017-02-23T17:17:58' (o similar)
Console.WriteLine("convertir {0} a string con formato ISO-8859-1 sin tiempo", dateDummy);
Console.WriteLine("> resultado: '{0}'\r\n", dateDummy.DateTo(true));
// > resultado: '2017-02-23' (o similar)
stringDummy = "1979-03-14";
dateDummy = stringDummy.DateFrom();
Console.WriteLine("convertir '{0}' a DateTime", stringDummy);
Console.WriteLine("> resultado: '{0}'\r\n", dateDummy);
// > resultado: '1979-03-14 00:00:00' (o similar)
stringDummy = "1960-02-12T17:38";
dateDummy = stringDummy.DateFrom();
Console.WriteLine("convertir '{0}' a DateTime", stringDummy);
Console.WriteLine("> resultado: '{0}'\r\n", dateDummy);
// > resultado: '1960-02-12 17:38:00' (o similar)
}
}
}Y ¿para qué me sirve?
A simple vista no parece aportar mucho, pero te invito a que veas el siguiente código, analizalo y reflexionalo; considerando la parte simplificada del código, estas funciones de utilidad te ayudarian a escribir menos código repetitivo y sobre todo tener una mejor lectura del código.
using JclunaOficial; // importar el namespace
using System;
namespace MyApplication
{
class Persona
{
/*
* REGLA DE EVALUACIÓN
* -----------------------------------------------------------------------------------------
* Uno de los requerimientos es garantizar que el valor
* que un usuario asigna a un atributo del objeto cumpla
* con las siguientes condiciones:
*
* 1. el valor del atributo no puede quedar nulo
* 2. el valor del atributo debe estar en mayúsculas
* 3. el valor del atributo solo debe tener un espacio intermedio entre palabras
* 4. el valor del atributo no debe tener más de 150 caracteres
* -----------------------------------------------------------------------------------------
* */
private string _eTradicional;
private string _eSimplificada;
// ejemplo de la forma tradicional de aplicar la regla
public string EvaluacionTradicional
{
get { return _eTradicional; }
set
{
// 1. no puede quedar nulo
_eTradicional = (value == null ? "" : value.Trim());
// 2. convertir a mayúsculas
_eTradicional.ToUpper();
// 3. debe quedar solamente un espacio entre palabras
while (true)
{
// determinar si hay espacios dobles
if (_eTradicional.Contains(" ") == false)
break; // ya no hay expacios dobles
// reemplazar los espacios dobles por uno solo
_eTradicional = _eTradicional.Replace(" ", " ");
}
// 4. no debe tener más de 150 caracteres
if (_eTradicional.Length > 150)
_eTradicional = _eTradicional.Substring(0, 150);
}
}
// ejemplo de la forma simplificada de aplicar la regla
public string EvaluacionSimplificada
{
get { return _eSimplificada; }
set { _eSimplificada = value.SingleSpace().Upper(150); } // <- 1,3,2,4: en una sola línea
}
}
}