Documentacion de las funciones agregadas (hasta que se publique la documentacion oficial):
StrFormat(DestStr[], Size, Pack=false, const FormatStr[], ...)
Convierte valores a texto, utilizando una cadena con formato.
Entradas:
- DestStr[] = Array con el resultado formateado (maximo 160 caracteres).
- Size = Numero maximo de celdas a utilizar en DestStr[] incluyendo el terminador '\0'.
- Pack = Utilizar siempre "false" en la implementacion actual.
- FormatStr[] = Cadena con el formato y codigos de formato.
- ... = Parametros para los codigos de formato en FormatStr[]
Retorno:
- ( >=0) = Retorna el numero de caracteres impresos en DestStr[] (sin incluir el terminador '\0')
- ( -1 ) = Direccion invalida de Array/String.
- ( -2 ) = Error en la conversion.
Notas:
Los codigos de formatos posibles pueden obtenerse de la funcion LcdPrintf()
desde el manual de programacion Pawn, ya que el modo de operacion es igual,
pero la salida no es en el display LCD, sino en un array.
Ejemplo:
new Str1[] = "Hola"
new StrNum[20]
new i=0
// Imprimir valor de variable "i" en cadena y luego incrementar.
StrFormat(StrNum, 20, false, "%s: %d", Str1, i++)
La cadena resultante en StrNum[] sera:
"Hola: 0"
Si se llama otra vez a la funcion, la cadena resultante sera:
"Hola: 1"
StrLen(const Str[])
Retorna la longitud de un string.
Entradas:
- Str[] = Array con el string para obtener longitud.
Retorno:
- ( >=0) = Tamaño de string (sin incluir el terminador '\0')
StrCmp(const Str1[], const Str2[], IgnoreCase=false, Length)
Compara dos strings.
Entradas:
- Str1[] = String 1.
- Str2[] = String 2.
- IgnoreCase = Si es "true" mayusculas/minusculas son ignoradas.
- Length = Cantidad maxima de caracteres a considerar en la comparacion.
Retorno:
- ( 0 ) = Los strings son inguales, Str1=Str2.
- ( -1 ) = El Str1 < Str2.
- ( 1 ) = El Str1 > Str2.
StrFind(const Str[], const SubStr[], IgnoreCase=false, Index=0)
Busca una sub-string dentro de un string.
Entradas:
- Str[] = String donde buscar la sub-string.
- SubStr[] = Sub-string a buscar.
- IgnoreCase = Si es "true" mayusculas/minusculas son ignoradas.
- Index = Posicion del caracter donde comenzar la busqueda en "Str[]".
Retorno:
- ( >=0 ) = Posicion del caracter (Index) en Str[] de la primera ocurrencia
de SubStr[]. Puede utilizar este numero (mas 1) como parametro
de Index para la busqueda de la siguiente ocurrencia en Str[].
- ( -1 ) = No se encontro SubStr[] en Str[].
StrCat(StrDest[], const Str1[], Length)
Concatena dos cadenas, resultando StrDest[] = StrDest[] + Str1[]
Entradas:
- StrDest[] = Cadena de destino.
- Str1[] = Cadena que se agregara a StrDest[].
- Length = Cantidad maxima de caracteres en StrDest[].
Retorno:
- ( >=0 ) = Tamaño resultante en caracteres de StrDest[], sin incluir terminador '\0'.