Menu
CoddyTech

Valores de Retorno

Parte da seção Funções, pilha e strings do Journey de Assembly da Coddy. Lição 12 de 33.

Uma função devolve seu resultado em rax. Quem a chama lê rax logo após o call, antes que qualquer outra coisa o altere.

Escrever sua própria função segue as mesmas regras: um rótulo, código que lê seus argumentos de rdi, rsi, rdx e deixa o resultado em rax, depois ret.

; sum3(rdi, rsi, rdx): retorna rdi + rsi + rdx
sum3:
    mov rax, rdi
    add rax, rsi
    add rax, rdx
    ret

Quando solve recebe os mesmos argumentos que deseja passar adiante, eles já estão nos registradores certos, então pode chamar imediatamente e usar o resultado:

solve:
    call sum3       ; rax = a soma das três entradas
    imul rax, rax, 2
    ret

Um rótulo que começa com um ponto, como .done, pertence ao último rótulo sem ponto que aparece antes dele. Assim, duas funções podem ter seu próprio .done; nomeie cada função com um rótulo simples, como sum3.

rax é o registrador de resultado, então uma chamada sempre o altera, até mesmo uma chamada a uma função que não retorna nada útil. Nunca conte que rax manterá um valor durante uma call: salve-o primeiro com push.

challenge icon

Desafio

Fácil

Escreva uma função clamp: um valor em rdi, um limite inferior em rsi e um limite superior em rdx (todos de -1000 a 1000, e o limite inferior nunca é maior que o superior). Ela retorna o valor em rax, ajustado para o limite inferior ou para o limite superior quando está fora desses limites. solve recebe os mesmos três números em rdi, rsi e rdx: chame clamp e retorne o resultado multiplicado por 2 em rax.

Exemplo: para a entrada 5 1 10, o programa imprime 10.

Escreva seu código em solution.asm. O arquivo bloqueado main.asm lê a entrada, chama solve e imprime o número em rax ou o nome de um registrador preservado pelo chamador que solve alterou.

Experimente você mesmo

bits 64
section .data
    changed_rbx db 'solve changed rbx', 10
    changed_rbp db 'solve changed rbp', 10
    changed_r12 db 'solve changed r12', 10
    changed_r13 db 'solve changed r13', 10
    changed_r14 db 'solve changed r14', 10
    changed_r15 db 'solve changed r15', 10
section .bss
    input_buffer resb 256
    output_buffer resb 32
    values resq 4
section .text
    global _start
    extern solve
_start:
    xor eax, eax
    xor edi, edi
    mov rsi, input_buffer
    mov edx, 255
    syscall
    test rax, rax
    jle .loaded
    mov rsi, input_buffer
    lea rdi, [input_buffer + rax]
    xor ecx, ecx
.scan:
    cmp rsi, rdi
    jae .loaded
    cmp ecx, 4
    jae .loaded
    movzx eax, byte [rsi]
    cmp al, 32
    jbe .space
    mov r10, 1
    cmp al, '-'
    jne .number
    mov r10, -1
    inc rsi
.number:
    xor eax, eax
.digit:
    cmp rsi, rdi
    jae .store
    movzx edx, byte [rsi]
    cmp dl, '0'
    jb .store
    cmp dl, '9'
    ja .store
    imul rax, rax, 10
    sub edx, '0'
    add rax, rdx
    inc rsi
    jmp .digit
.store:
    imul rax, r10
    mov [values + rcx * 8], rax
    inc ecx
.space:
    inc rsi
    jmp .scan
.loaded:
    mov rbx, 0x1111111111111111
    mov rbp, 0x2222222222222222
    mov r12, 0x3333333333333333
    mov r13, 0x4444444444444444
    mov r14, 0x5555555555555555
    mov r15, 0x6666666666666666
    mov rdi, [values]
    mov rsi, [values + 8]
    mov rdx, [values + 16]
    mov rcx, [values + 24]
    xor eax, eax
    call solve
    mov rdx, 0x1111111111111111
    lea rsi, [changed_rbx]
    cmp rbx, rdx
    jne .changed
    mov rdx, 0x2222222222222222
    lea rsi, [changed_rbp]
    cmp rbp, rdx
    jne .changed
    mov rdx, 0x3333333333333333
    lea rsi, [changed_r12]
    cmp r12, rdx
    jne .changed
    mov rdx, 0x4444444444444444
    lea rsi, [changed_r13]
    cmp r13, rdx
    jne .changed
    mov rdx, 0x5555555555555555
    lea rsi, [changed_r14]
    cmp r14, rdx
    jne .changed
    mov rdx, 0x6666666666666666
    lea rsi, [changed_r15]
    cmp r15, rdx
    jne .changed
    lea rsi, [output_buffer + 31]
    mov byte [rsi], 10
    mov ecx, 1
    xor r8d, r8d
    test rax, rax
    jns .positive
    mov r8d, 1
    neg rax
.positive:
    mov r9d, 10
.convert:
    xor edx, edx
    div r9
    add dl, '0'
    dec rsi
    mov [rsi], dl
    inc ecx
    test rax, rax
    jnz .convert
    test r8d, r8d
    jz .write
    dec rsi
    mov byte [rsi], '-'
    inc ecx
.write:
    mov edx, ecx
    mov eax, 1
    mov edi, 1
    syscall
.exit:
    mov eax, 60
    xor edi, edi
    syscall
.changed:
    mov eax, 1
    mov edi, 1
    mov edx, 18
    syscall
    jmp .exit

Todas as lições de Funções, pilha e strings

Pratique por conta própria: Playground de Assembly