JSON Funciones

Antes de leer esta guía, deberías estar familiarizado con JSON y dónde y cómo se utiliza. Puedes familiarizarte con JSON leyendo un tutorial en Mozzilla.

$jsonParse es la función principal utilizada cuando se trabaja con datos JSON.
Esta función analiza una cadena JSON y la convierte en un objeto que luego puede ser utilizado por otras funciones JSON.

Sintaxis

$jsonParse[JSON string]

Solo puede usar para claves y valores en str este tipo de comilla: '

Parámetros

JSON string (Tipo: String || Obligatorio): La cadena JSON que se analizará y convertirá en un objeto.

Ejemplo:

JSON guardado. $jsonParse[{'numero': 100}]

alt text

$json[]

La función $json recupera valores JSON de una clave especificada en el objeto JSON actual.

La función $json devolverá una cadena vacía si el valor es nulo, la clave no existe, no se ejecutaron las funciones $jsonParse o $jsonSet, o se ejecutó $jsonClear.

Sintaxis

$json[Key;...]

Parámetros

Key (Tipo: String || Flag: Required): La clave JSON que se recuperará.

Ejemplos

# Sin arrays

$jsonParse[{
    'username': 'Izana',
    'tag': '6700',
    'identity': {
        'age': 16
        }
    }]

Nombre de usuario: $json[username]
Etiqueta: $json[tag]
Edad: $json[identity;age] años

alt text

$jsonSet[]

La función $jsonSet establece o reemplaza el valor en la clave JSON especificada.

Sintaxis

$jsonSet[Key;...;Value]

Parámetros

Key (Tipo: String || Obligatorio): La clave JSON donde se establecerá o reemplazará el valor.
Value (Tipo: Integer, Bool, Float, String || Obligatorio): El valor que se asignará o reemplazará en la clave especificada.

Ejemplo

$jsonParse[{
    'username': 'Izana',
    'tag': "6700",
    'identity': {
        'age': 16
    }
}]

Nombre de usuario: $json[username]  
Etiqueta: $json[tag]  
Edad: $json[identity;age] años  

$jsonSet[username;Priyanuj]  
$jsonSet[tag;2626]  
$jsonSet[identity;age;19]  


Nombre de usuario: $json[username]  
Etiqueta: $json[tag]  
Edad: $json[identity;age] años

alt text

$jsonSetString[]

La función $jsonSetString establece o reemplaza el valor en la clave JSON especificada. Siempre establece el valor como una cadena.

Sintaxis

$jsonSetString[Key;...;Value]

Parámetros

Key (Tipo: String || Flag: Required): La clave JSON donde se establecerá o reemplazará el valor.
Value (Tipo: String || Flag: Required): El valor a establecer o reemplazar.

Esta función se recomienda principalmente para comandos relacionados con economía.

Ejemplo

$nomention
$jsonParse[{}]

$jsonSet[balance;$message]

Balance key was set to: $json[balance]

alt text

Usando $jsonSetString

$nomention
$jsonParse[{}]

$jsonSetString[balance;$message]

Balance key was set to: $json[balance]

alt text

$jsonUnset[]

La función $jsonUnset elimina el valor en la clave JSON especificada.
En resumen, es la función opuesta a $jsonSet.

Sintaxis

$jsonUnset[Key;...]

Parámetros

Key (Tipo: String || Flag: Required): La clave JSON que se eliminará.

Ejemplo

$jsonParse[{
    "username": "NightNutSky",
    "tag": "6700",
    "identity": {
        "age": 16
    }
}]

Username: $json[username]
Tag: $json[tag]
Age: $json[identity;age] years old

$jsonUnset[username]
$jsonUnset[tag]
$jsonUnset[identity;age]

$optOff[Username: $json[username]
Tag: $json[tag]
Age: $json[identity;age] years old]

alt text

$jsonClear[]

La función $jsonClear elimina el objeto JSON actual, restableciendo su contenido.

Sintaxis

$jsonClear[]

Ejemplo

$jsonParse[{
    'username': 'Izana',
    'tag': '6700',
    'identity': {
        'age': 16
        }
    }]
Nombre de usuario: $json[username]  
$jsonClear[]
Nombre de usuario: $json[username]

alt text

$jsonExists[]

La función $jsonExists verifica si una clave JSON especificada existe en el objeto JSON actual.

Devuelve un resultado vacío si no se ejecutaron las funciones $jsonParse o $jsonSet, o si se ejecutó $jsonClear.

Sintaxis

$jsonExists[Key;...]

Parámetros

Key (Tipo: String || Flag: Required): La clave JSON que se verificará.

Ejemplo

$jsonParse[{
    'user': {
        'name': 'Amisadai',
        'age': 20
    }
}]

$jsonExists[user;name] ✅ La clave 'name' existe.
$jsonExists[user;email] ❌ La clave 'email' no existe.

alt text

$jsonStringify[]

La función $jsonStringify[] convierte el objeto JSON actual en una cadena de texto.

La función $jsonStringify[] devolverá una cadena vacía si no se ejecutaron las funciones $jsonParse o $jsonSet, o si se ejecutó $jsonClear.

Sintaxis

$jsonStringify[]

Ejemplo


$jsonParse[{
    'computer': [{
        'apps': {
            'software': ['BlueStacks', 'Krita', 'Visual Studio Code'],
            'games': ['GTA 5', 'RDR 2', 'CS:GO', 'Cyberpunk 2077']
        }
    },{
        'cpu': 'Intel',
        'gpu': 'NVIDIA',
        'ram': 'XPG'
    }]
}]

$jsonStringify[]

alt text

$jsonPretty[]

La función $jsonPretty convierte el objeto JSON actual en una cadena formateada con sangría para una mejor visualización.

La función $jsonPretty devolverá un resultado vacío si no se ejecutaron las funciones $jsonParse o $jsonSet, o si se ejecutó $jsonClear.

Sintaxis

$jsonPretty[Indent length]

Parámetros

Indent length (Tipo: Integer || Flag: Required): La cantidad de espacios usados para la indentación. Generalmente es 2 o 4.

Ejemplo

$nomention
$disableInnerSpaceRemoval
$jsonParse[{
    'ordenador': [{
        'aplicaciones': {
            'software': ['BlueStacks', 'Krita', 'Visual Studio Code'],
            'games': ['GTA 5', 'RDR 2', 'CS:GO', 'Cyberpunk 2077']
        }
    },{
        'cpu': 'Intel',
        'gpu': 'NVIDIA',
        'ram': 'XPG'
    }]
}]

$jsonPretty[4]

alt text

$jsonArray []

La función $jsonArray marca una clave JSON especificada como un array.

Sintaxis

$jsonArray[Key;...]

Parámetros

Key (Tipo: String || Obligatorio): La clave JSON que será marcada como un array.

Ejemplo


$jsonParse[{
    'games': ''
}]

Clave `games` sin array:  
$jsonPretty[4]  

$jsonArray[games]  

Clave `games` convertida en array:  
$jsonPretty[4]

alt text

$jsonArrayCount[]

La función $jsonArrayCount cuenta los elementos en la clave JSON especificada.

Sintaxis

$jsonArrayCount[Key;...]

Parámetros

key (Tipo: String || Obligatorio) La clave JSON donde se contarán los elementos.

Ejemplo


$jsonParse[{
    'computer': [{
        'apps': {
            'software': ['BlueStacks', 'Krita', 'Visual Studio Code'],
            "games": ['GTA 5', 'RDR 2', 'CS:GO', 'Cyberpunk 2077']
        }
    },{
        'cpu': 'Intel',
        'gpu': 'NVIDIA',
        'ram': 'XPG'
    }]
}]

$onlyIf[$checkCondition[$jsonExists[computer;0;apps;$message[-1]]==true];¡La categoría especificada no existe! Categorías disponibles: `software` y `games`]

La cantidad de aplicaciones en `$message[-1]` es: $jsonArrayCount[computer;0;apps;$message[-1]].

alt text

$jsonArrayIndex[]

La función $jsonArrayIndex obtiene el índice de un valor dentro de un array JSON.

La función $jsonArrayIndex devolverá -1 si el valor no se encuentra y devolverá un resultado vacío si no se ejecutaron $jsonParse o $jsonSet, o si se ejecutó $jsonClear.

Sintaxis

$jsonArrayIndex[Key;...;Value]

Parámetros

key (Tipo: String || Obligatorio) La clave JSON donde se buscará el valor.
value (Tipo: String, Integer, Float || Obligatorio) El valor a buscar dentro del array.

Ejemplo

$jsonParse[{
    'computer': [{
        'apps': {
            'software': ['BlueStacks', 'Krita', 'Visual Studio Code'],
            "games": ['GTA 5', 'RDR 2', 'CS:GO', 'Cyberpunk 2077']
        }
    },{
        'cpu': 'Intel',
        'gpu': 'NVIDIA',
        'ram': 'XPG'
    }]
}]


El índice de `$message[-1]` en `apps/software` es: $jsonArrayIndex[computer;0;apps;software;$message[-1]].

alt text

$jsonArrayAppend[]

La función $jsonArrayAppend agrega un valor al final de la clave JSON especificada.

Sintaxis

$jsonArrayAppend[Key;...;Value]

Parámetros

key (Tipo: String || Obligatorio) La clave JSON donde se agregará el valor.
value (Tipo: Integer, Bool, Float, String || Obligatorio) El valor que se agregará al final del array.

Ejemplo

$jsonParse[{
    'computer': [{
        'apps': {
            'software': ['BlueStacks', 'Krita', 'Visual Studio Code'],
            'games': ['GTA 5', 'RDR 2', 'CS:GO', 'Cyberpunk 2077']
        }
    },{
        'cpu': 'Intel',
        'gpu': 'NVIDIA',
        'ram': 'XPG'
    }]
}]

$onlyIf[$checkCondtion[$jsonExists[computer;0;apps;$message[1]]==true];¡La categoría especificada no existe! Categorías disponibles: `software` y `games`]

$let[value;$replaceText[$message[-1];$message[1];]]

$jsonArrayAppend[computer;0;apps;$message[1];$get[value]]

¡Se agregó una nueva aplicación a la categoría `$message[1]`!  
Aplicaciones actuales en la categoría `$message[1]`: $json[computer;0;apps;$message[1]]

alt text

$jsonArrayPop[]

La función $jsonArrayPop elimina el último elemento de un array y devuelve el elemento eliminado.

Sintaxis

$jsonArrayPop[Key;...]

Parámetros

key (Tipo: String || Obligatorio) La clave del array del cual se eliminará un elemento.

Ejemplo

$jsonParse[{
    'music': ['Paranoid - MADKID', 'Ping! 2 - Exyl', 'Tokyo - Leat'eq']
}]

Eliminado: $jsonArrayPop[musica]

Música actual:
> $jsonJoinArray[musica;, ]

alt text

$jsonArrayShift[]

La función $jsonArrayShift[] elimina el primer elemento de un array y devuelve el elemento eliminado.

Sintaxis

$jsonArrayShift[Key;...]

Parámetros

key (Tipo: String || Obligatorio) La clave del array del cual se eliminará un elemento.

Ejemplo

$jsonParse[{
    'music': ['Paranoid - MADKID', 'Ping! 2 - Exyl', 'Tokyo - Leateq']
}]

Eliminado: $jsonArrayShift[music]

Música actual:
> $jsonJoinArray[music;, ]

alt text

$jsonArrayUnshift[]

La función $jsonArrayUnshift agrega un valor al inicio de un array JSON.

Sintaxis

$jsonArrayUnshift[Key;...;Value]

Parámetros

key (Tipo: String || Requerido) La clave del array JSON donde se añadirá el valor.
value (Tipo: Float, String, Bool, Integer || Requerido) El valor que se agregará al inicio del array.

Ejemplo

$jsonParse[{
    'music': ['Paranoid - MADKID', 'Ping! 2 - Exyl, 'Tokyo - Leat'eq]
}]

$jsonArrayUnshift[music;Side Character - Cloudfodder]

Música:
> $jsonJoinArray[music;, ]

alt text

$jsonArraySort[]

La función $jsonArraySort ordena un array JSON específico en orden ascendente.

La función ordena los elementos en el siguiente orden:

Números enteros de menor a mayor.

Cadenas de texto basadas en sus valores ASCII/Unicode.

Sintaxis

$jsonArraySort[Key;...]

Parámetros

key (Tipo: String || Opcional) La clave del array JSON que se ordenará.

Ejemplo

$jsonParse[{
  'data': ['Oranges', 'banana', 10, 'apple', 'Apples', 2, 30]
}]

$jsonArraySort[data]

Después de ordenar:
> $json[data]

alt text

$jsonArrayReverse[]

La función $jsonArrayReverse invierte el orden de un array JSON específico.

Sintaxis

$jsonArrayReverse[Key;...]

Parámetros

key (Tipo: String || Opcional) La clave del array JSON que se invertirá.

Ejemplo


$jsonParse[{
  'fruits': ['apple', 'orange', 'banana', 'grape']
}]

$jsonArrayReverse[fruits]

Después de invertir:
> $json[fruits]

alt text

$jsonJoinArray[]

La función $jsonJoinArray une un array JSON bajo la clave especificada utilizando el separador dado.

La función $jsonJoinArray devolverá una cadena vacía si el valor es null, la clave no existe, no se ejecutaron las funciones $jsonParse o $jsonSet, o si se ejecutó $jsonClear.

Sintaxis

$jsonJoinArray[Key;...;Separator]

Parámetros

Key (Tipo: String || Flag: Required): La clave JSON que apunta a un array que será recuperado.
Separator (Tipo: String || Flag: Required): El separador que se utilizará para unir los elementos del array.

Ejemplo


$jsonParse[{
    'music': ['Paranoid - MADKID', 'Ping! 2 - Exyl', 'Tokyo - Leat\'eq']
}]

Music:
> $jsonJoinArray[music;, ]

alt text

AmisynthDocs

JSON Funciones

Funciones utilizadas

$jsonParse[]

$json[]

$jsonSet[]

$jsonSetString[]

$jsonUnset[]

$jsonClear[]

$jsonExists[]

$jsonStringify[]

$jsonPretty[]

$jsonArray []

$jsonArrayCount[]

$jsonArrayIndex[]

$jsonArrayAppend[]

$jsonArrayPop[]

$jsonArrayShift[]

$jsonArrayUnshift[]

$jsonArraySort[]

$jsonArrayReverse[]

$jsonJoinArray[]