Todos os produtos
Search

Este produto

    CDN:Funções de dicionário

    Central de documentação

    CDN:Funções de dicionário

    Última atualização: Aug 27, 2026

    Este tópico descreve a sintaxe, os parâmetros e os valores de retorno das funções de dicionário. Também apresenta exemplos práticos dessas funções.

    defina

    Use a função set para adicionar ou atualizar um par chave-valor em um dicionário.

    Item

    Descrição

    Sintaxe

    set(d, k, v)

    Parâmetros

    • d: O dicionário de destino.

    • k: A chave a adicionar ou atualize. Tipo de dados: qualquer.

    • v: O valor a associar à chave. Tipo de dados: qualquer.

    Exemplos

    • Exemplo 1 

      outer_keys=['e66fd4aa-f281-472f-b919-fc7e7474****', '66fee78d-1887-42ec-9119-a9b50b7f****']
say(concat('keys[1]=', get(outer_keys, 1)))
say(concat('keys[2]=', get(outer_keys, 2)))

inner_keys=[]
set(inner_keys, 'dev', '243390eb-00b7-4551-a6b8-021bb34d****')
set(inner_keys, 'zeus', '4747d33b-12b0-45e6-ac10-a8e191d6****')

def echo_each(k, v, u) {
    s = concat('keys[', k, ']=', v)
    say(s)
}
foreach(inner_keys, echo_each, [])

    • Exemplo 2 

      d_inner = []
    set(d_inner, 'name', 'inner dsl')

    d_outer = []
    set(d_outer, 'dictA', d_inner)

    v = get(d_outer, 'dictA')
    if v {
        v = get(v, 'name')
        if v {
            add_rsp_header('X-DSL-NESTED-DICT', v)
        }
    }

    Valor de retorno

    Esta função sempre retorna true. Os exemplos produzem a seguinte saída:

    • Saída do Exemplo 1:

      keys[1]=e66fd4aa-f281-472f-b919-fc7e7474****
    keys[2]=66fee78d-1887-42ec-9119-a9b50b7f****
    keys[dev]=243390eb-00b7-4551-a6b8-021bb34d****
    keys[zeus]=4747d33b-12b0-45e6-ac10-a8e191d6****

    • O Exemplo 2 adiciona o seguinte cabeçalho de resposta:

      X-DSL-NESTED-DICT: inner dsl

    get

    Use a função get para recuperar o valor associado a uma chave específica em um dicionário.

    Item

    Descrição

    Sintaxe

    get(d, k)

    Parâmetros

    • d: O dicionário de destino.

    • k: A chave do valor a recuperar. Tipo de dados: qualquer.

    Exemplo

    outer_keys=['e66fd4aa-f281-472f-b919-fc7e7474****', '66fee78d-1887-42ec-9119-a9b50b7f****']
say(concat('keys[1]=', get(outer_keys, 1)))
say(concat('keys[2]=', get(outer_keys, 2)))

inner_keys=[]
set(inner_keys, 'dev', '243390eb-00b7-4551-a6b8-021bb34d****')
set(inner_keys, 'zeus', '4747d33b-12b0-45e6-ac10-a8e191d6****')

def echo_each(k, v, u) {
    s = concat('keys[', k, ']=', v)
    say(s)
}
foreach(inner_keys, echo_each, [])

    Valor de retorno

    Se a chave existir, a função retornará o valor correspondente. Caso contrário, retornará false. O exemplo produz a seguinte saída:

    keys[1]=e66fd4aa-f281-472f-b919-fc7e7474****
    keys[2]=66fee78d-1887-42ec-9119-a9b50b7f****
    keys[dev]=243390eb-00b7-4551-a6b8-021bb34d****
    keys[zeus]=4747d33b-12b0-45e6-ac10-a8e191d6****

    foreach

    A função foreach tem os seguintes comportamentos:

    • Itera sobre cada par chave-valor no dicionário d e executa a função de callback f.

    • A função de callback f deve ter a assinatura f(key, value, user_data).

    • O loop foreach() termina se a função de callback f() retornar false.

    Item

    Descrição

    Sintaxe

    foreach(d, f, user_data)

    Parâmetros

    • d: O dicionário de destino.

    • f: A função de callback a executar para cada par chave-valor.

    • user_data: Dados personalizados do usuário a passar para a função de callback. Este parâmetro deve ser um dicionário.

    Exemplos

    • Exemplo 1 

      outer_keys=['e66fd4aa-f281-472f-b919-fc7e7474****', '66fee78d-1887-42ec-9119-a9b50b7f****']
say(concat('keys[1]=', get(outer_keys, 1)))
say(concat('keys[2]=', get(outer_keys, 2)))

inner_keys=[]
set(inner_keys, 'dev', '243390eb-00b7-4551-a6b8-021bb34d****')
set(inner_keys, 'zeus', '4747d33b-12b0-45e6-ac10-a8e191d6****')

def echo_each(k, v, u) {
    s = concat('keys[', k, ']=', v)
    say(s)
}
foreach(inner_keys, echo_each, [])

    • Exemplo 2

      Este exemplo imprime os dois primeiros segmentos M3U8 e demonstra como encerrar o loop foreach. 

      def echo_each(k, v, u) {
        say(v)

        if match_re(v, '.*ts') {
            ts_cnt = get(u, 'ts_cnt')
            ts_cnt = add(ts_cnt, 1)
            set(u, 'ts_cnt', ts_cnt)

            if ge(ts_cnt, 2) {
                return false
            }
        }
    }

    m3u8 = ''
    m3u8 = concat(m3u8, '#EXTM3U8', '\n')
    m3u8 = concat(m3u8, '#EXT-X-MEDIA-SEQUENCE:14065****\n')
    m3u8 = concat(m3u8, '#EXT-X-TARGETDURATION:10\n')
    m3u8 = concat(m3u8, '#EXTINF:8,\n')
    m3u8 = concat(m3u8, 'http://***.cn/cache/289_/seg0/index140651514_1406****.ts\n')
    m3u8 = concat(m3u8, '#EXTINF:9,\n')
    m3u8 = concat(m3u8, 'http://***.cn/cache/289_/seg0/index140651514_1406****.ts\n')
    m3u8 = concat(m3u8, '#EXTINF:10,\n')
    m3u8 = concat(m3u8, 'http://***.cn/cache/289_/seg0/index140651514_1406****.ts\n')

    lines = split(m3u8, '\n')
    u = []
    set(u, 'ts_cnt', 0)
    foreach(lines, echo_each, u)

    Valor de retorno

    Esta função sempre retorna true. Os exemplos produzem a seguinte saída:

    • Saída do Exemplo 1:

      keys[1]=e66fd4aa-f281-472f-b919-fc7e7474****
    keys[2]=66fee78d-1887-42ec-9119-a9b50b7f****
    keys[dev]=243390eb-00b7-4551-a6b8-021bb34d****
    keys[zeus]=4747d33b-12b0-45e6-ac10-a8e191d6****

    • Saída do Exemplo 2:

      #EXTM3U8
    #EXT-X-MEDIA-SEQUENCE:140651513
    #EXT-X-TARGETDURATION:10
    #EXTINF:8,
    http://***.cn/cache/289_/seg0/index140651514_1406****.ts
    #EXTINF:9,
    http://***.cn/cache/289_/seg0/index140651514_1406****.ts

    del

    Exclui pares chave-valor de um dicionário (d). A tabela a seguir detalha esta função.

    Item

    Descrição

    Sintaxe

    del(d, k)

    Parâmetros

    • d: o nome do dicionário.

    • k: a chave. Tipo de dados: qualquer.

    Exemplos

    var_a = []
set(var_a, 'note_a', 'note a info')
if get(var_a, 'note_a') {
    add_rsp_header('X-RESPOND-OUTPUT', 'found var_a key', true)
} else {
    add_rsp_header('X-RESPOND-OUTPUT', 'del var_a key', true)
}
del(var_a, 'note_a')
if get(var_a, 'note_a') {
    add_rsp_header('X-RESPOND-OUTPUT', 'found var_a key', true)
} else {
    add_rsp_header('X-RESPOND-OUTPUT', 'del var_a key', true)
}

    Parâmetros de resposta

    Retorna o valor true. Parâmetro de resposta deste exemplo:

    X-RESPOND-OUTPUT: found var_a key
X-RESPOND-OUTPUT: del var_a key