gavmac00/arduino-docs huggingface dataset:
Linguagem
funções
variáveis
estrutura
Bibliotecas
IoT Cloud API
Glossário
        A documentação de referência da linguagem Arduino está licenciada sob a licença Creative Commons Attribution-Share Alike 3.0.
    
    Encontrou alguma coisa que pode ser melhorada? Sugira correções e nova documentação via GitHub.
    
    Dúvidas sobre como usar o Github? Aprenda tudo o que precisa saber nesse tutorial.
    
Last Revision: Searching...
Last Build: 2023/06/30 
Editar essa Página
Reference
            >  Language
            >  Functions
            >  Math
            > Map
          
map()
          [Math]
          
Descrição
> Map
          
map()
          [Math]
          
Descrição
Remapeia um número de um intervalo para outro. Isto é, um valor de deMenor seria mapeado para paraMenor, um valor de deMaior para paraMaior, valores dentro de uma faixa para valores dentro da outra faixa, etc.
Não restringe valores a ficar dentro do intervalo, porque valores fora do intervalo são as vezes úteis e pretendidos. A função constrain() pode ser usada tanto antes como depois dessa função, se limites para os intervalos são desejados.
Note que os "limites mínimos" de cada intervalo podem ser maiores ou menores que os "limites máximos" tal que a função map() pode ser usada para reverter um intervalo de números, por exemplo
y = map(x, 1, 50, 50, 1);
A função também funciona bem com números negativos, tal que esse exemplo
y = map(x, 1, 50, 50, -100);
também é valido e funciona bem.
A função map() usa números inteiros e não irá gerar números fracionários, quando a matemática indicar que deveria. Resíduos fracionários são truncados e não são arredondados.
Sintaxe
=map(valor, deMenor, deMaior, paraMenor, paraMaior);
Parâmetros
valor: o número a ser mapeado
deMenor: o menor limite do intervalo atual do valor
deMaior: o maior limite do intervalo atual do valor
paraMenor: o menor limite do intervalo alvo
paraMenor: o menor limite do intervalo alvo
paraMaior: o maior limite do intervalo alvo
Retorna
O valor mapeado para o novo intervalo.
Código de Exemplo
/* Mapeia um valor analógico para 8 bits (0 a 255) */
void setup() {}
void loop() {
  int val = analogRead(0);
  val = map(val, 0, 1023, 0, 255);
  analogWrite(9, val);
}
Apêndice
Para os matematicamnete interessados, aqui tem-se o código da função:
long map(long x, long in_min, long in_max, long out_min, long out_max) {
  return (x - in_min) * (out_max - out_min) / (in_max - in_min) + out_min;
}
}
Notes & Warnings
Como mencionado anteriormente, a função map() usa matemática inteira. Então frações podem ser suprimidas devido a isso. Por exemplo, frações como 3/2, 4/3, 5/4 irão ser retornadas como 1 pela função map(), apesar de os valores esperados serem diferentes. Então, se seu projeto requer cálculos precisos (ex. tensão elétrica com precisão de três decimais), por gentileza considere evitar a função map() e implementar os cálculos manualmente no seu código.
Ver Também
Linguagem
funções
variáveis
estrutura
Bibliotecas
IoT Cloud API
Glossário
        A documentação de referência da linguagem Arduino está licenciada sob a licença Creative Commons Attribution-Share Alike 3.0.
    
    Encontrou alguma coisa que pode ser melhorada? Sugira correções e nova documentação via GitHub.
    
    Dúvidas sobre como usar o Github? Aprenda tudo o que precisa saber nesse tutorial.
    
Last Revision: Searching...
Last Build: 2023/06/30 
Editar essa Página
Reference
            >  Language
            >  Functions
            >  Math
            > Sqrt
          
sqrt()
          [Math]
          
Descrição
Calcula a raiz quadrada de um número.
Sintaxe
sqrt(x)
Parâmetros
Linguagem
funções
variáveis
estrutura
Bibliotecas
IoT Cloud API
Glossário
        A documentação de referência da linguagem Arduino está licenciada sob a licença Creative Commons Attribution-Share Alike 3.0.
    
    Encontrou alguma coisa que pode ser melhorada? Sugira correções e nova documentação via GitHub.
    
    Dúvidas sobre como usar o Github? Aprenda tudo o que precisa saber nesse tutorial.
    
Last Revision: Searching...
Last Build: 2023/06/30 
Editar essa Página
Reference
            >  Language
            >  Functions
            >  Trigonometry
            > Cos
          
cos()
          [Trigonometry]
          
Descrição
cos()
          [Trigonometry]
          
Descrição
Calcula o cosseno de um ângulo (em radianos). O resultado é dado entre -1 e 1.
Sintaxe
cos(rad)
Parâmetros
rad: O ângulo em radianos (float).
Retorna
O cosseno do ângulo (double).
Ver Também
LINGUAGEM float
LINGUAGEM double
Linguagem
funções
variáveis
estrutura
Bibliotecas
IoT Cloud API
Glossário
        A documentação de referência da linguagem Arduino está licenciada sob a licença Creative Commons Attribution-Share Alike 3.0.
    
    Encontrou alguma coisa que pode ser melhorada? Sugira correções e nova documentação via GitHub.
    
    Dúvidas sobre como usar o Github? Aprenda tudo o que precisa saber nesse tutorial.
    
Last Revision: Searching...
Last Build: 2023/06/30 
Editar essa Página
Reference
            >  Language
            >  Functions
            >  Trigonometry
            > Tan
          
tan()
          [Trigonometry]
          
Descrição
tan()
          [Trigonometry]
          
Descrição
Calcula a tangente de um ângulo (em radianos). O resultado é dado entre -infinito e +infinito (limitado pela tamanho do tipo de dado double).
Sintaxe
tan(rad)
Parâmetros
rad: O ângulo em radianos (float).
Retorna
A tangente do ângulo (double).
Ver Também
LINGUAGEM float
LINGUAGEM double
Linguagem
funções
variáveis
estrutura
Bibliotecas
IoT Cloud API
Glossário
        A documentação de referência da linguagem Arduino está licenciada sob a licença Creative Commons Attribution-Share Alike 3.0.
    
    Encontrou alguma coisa que pode ser melhorada? Sugira correções e nova documentação via GitHub.
    
    Dúvidas sobre como usar o Github? Aprenda tudo o que precisa saber nesse tutorial.
    
Last Revision: Searching...
Last Build: 2023/06/30 
Editar essa Página
Reference
            >  Language
            >  Functions
            >  Trigonometry
            > Sin
          
sin()
          [Trigonometry]
          
Descrição
sin()
          [Trigonometry]
          
Descrição
Calcula o seno de um ângulo (em radianos). O resultado é dado entre -1 e 1.
Sintaxe
sin(rad)
Parâmetros
rad: O ângulo em radianos (float).
Retorna
O seno do ângulo (double).
Ver Também
LINGUAGEM float
LINGUAGEM double