mirror of
https://github.com/adambard/learnxinyminutes-docs.git
synced 2024-12-25 10:25:23 +00:00
599 lines
12 KiB
Markdown
599 lines
12 KiB
Markdown
---
|
|
language: ruby
|
|
filename: learnruby.rb
|
|
contributors:
|
|
- ["Bruno Henrique - Garu", "http://garulab.com"]
|
|
---
|
|
|
|
```ruby
|
|
# Isso é um comentario
|
|
|
|
=begin
|
|
This is a multiline comment
|
|
No-one uses them
|
|
You shouldn't either
|
|
|
|
Isso é um comentario multilinha
|
|
Ninguém os usa
|
|
|
|
=end
|
|
|
|
# First and foremost: Everything is an object.
|
|
# Primeiro e principal: Tudo é um objeto.
|
|
|
|
# Numbers are objects
|
|
# Números são objetos
|
|
|
|
3.class #=> Fixnum
|
|
|
|
3.to_s #=> "3"
|
|
|
|
|
|
# Some basic arithmetic
|
|
# Aritmética básica
|
|
|
|
1 + 1 #=> 2
|
|
8 - 1 #=> 7
|
|
10 * 2 #=> 20
|
|
35 / 5 #=> 7
|
|
|
|
# Arithmetic is just syntactic sugar
|
|
# for calling a method on an object
|
|
# Arithmetic é apenas açúcar semântico
|
|
# para chamar um métoddo de um objeto
|
|
1.+(3) #=> 4
|
|
10.* 5 #=> 50
|
|
|
|
# Special values are objects
|
|
# Valores especiais são obejetos
|
|
nil # Nothing to see here
|
|
nil # Nada para ver aqui
|
|
true # truth
|
|
true # verdadeiro
|
|
false # falsehood
|
|
false # falso
|
|
|
|
nil.class #=> NilClass
|
|
true.class #=> TrueClass
|
|
false.class #=> FalseClass
|
|
|
|
# Equality
|
|
# Igualdade
|
|
1 == 1 #=> true
|
|
2 == 1 #=> false
|
|
|
|
# Inequality
|
|
# Desigualdade
|
|
1 != 1 #=> false
|
|
2 != 1 #=> true
|
|
!true #=> false
|
|
!false #=> true
|
|
|
|
# apart from false itself, nil is the only other 'falsey' value
|
|
# além de 'false', 'nil' é o único outro valor falso
|
|
|
|
!nil #=> true
|
|
!false #=> true
|
|
!0 #=> false
|
|
|
|
# More comparisons
|
|
# Mais comparações
|
|
1 < 10 #=> true
|
|
1 > 10 #=> false
|
|
2 <= 2 #=> true
|
|
2 >= 2 #=> true
|
|
|
|
# Strings are objects
|
|
# Strings são obejetos
|
|
|
|
'I am a string'.class #=> String
|
|
'Eu sou uma string'.class #=> String
|
|
"I am a string too".class #=> String
|
|
"Eu também sou uma string".class #=> String
|
|
|
|
placeholder = "use string interpolation"
|
|
placeholder = "usar interpolação de string"
|
|
"I can #{placeholder} when using double quoted strings"
|
|
"Eu posso #{placeholder} quando estiver usando aspas duplas"
|
|
#=> "I can use string interpolation when using double quoted strings"
|
|
#=> "Eu posso usar insterpolação de string quando estiver usando aspas duplas"
|
|
|
|
|
|
# print to the output
|
|
# imprime para output (saida)
|
|
puts "I'm printing!"
|
|
puts "Estou imprimindo"
|
|
|
|
# Variables
|
|
# Variáveis
|
|
x = 25 #=> 25
|
|
x #=> 25
|
|
|
|
# Note that assignment returns the value assigned
|
|
# Note que uma atribuição retorna o valor atribuido
|
|
# This means you can do multiple assignment:
|
|
# Isso significa que você pode fazer multiplas atribuições:
|
|
|
|
x = y = 10 #=> 10
|
|
x #=> 10
|
|
y #=> 10
|
|
|
|
# By convention, use snake_case for variable names
|
|
# Por convenção, use snake_case para nomes de variáveis
|
|
snake_case = true
|
|
|
|
# Use descriptive variable names
|
|
# Use nomes de variáveis descrivos
|
|
path_to_project_root = '/good/name/'
|
|
caminho_para_a_raiz_do_projeto = '/bom/nome/'
|
|
path = '/bad/name/'
|
|
caminho = '/nome/ruim/'
|
|
|
|
# Symbols (are objects)
|
|
# Simbolos (são objetos)
|
|
# Symbols are immutable, reusable constants represented internally by an
|
|
# Simbolos são imultáveis, são constantes reutilizáveis representadadas internamente por um
|
|
# integer value. They're often used instead of strings to efficiently convey
|
|
# valor inteiro. Eles são frequentemente usados no lugar de strings para transmitir com eficiência os valores
|
|
# specific, meaningful values
|
|
# específicos e significativos
|
|
|
|
:pending.class #=> Symbol
|
|
:pendente.class #=> Symbol
|
|
|
|
status = :pending
|
|
status = :pendente
|
|
|
|
status == :pending #=> true
|
|
status == :pendente #=> true
|
|
|
|
status == 'pending' #=> false
|
|
status == 'pendente' #=> false
|
|
|
|
status == :approved #=> false
|
|
status == :aprovado #=> false
|
|
|
|
# Arrays
|
|
|
|
# This is an array
|
|
# Isso é um array
|
|
[1, 2, 3, 4, 5] #=> [1, 2, 3, 4, 5]
|
|
|
|
# Arrays can contain different types of items
|
|
# Arrays podem conter diferentes tipos de itens
|
|
|
|
array = [1, "hello", false] #=> => [1, "hello", false]
|
|
array = [1, "Oi", false] #=> => [1, "Oi", false]
|
|
|
|
# Arrays can be indexed
|
|
# Arrays podem ser indexados
|
|
# From the front
|
|
# a partir do começo
|
|
array[0] #=> 1
|
|
array[12] #=> nil
|
|
|
|
# Like arithmetic, [var] access
|
|
# Como aritimetica, o acesso via [var]
|
|
# is just syntactic sugar
|
|
# é apenas açúcar sintático
|
|
# for calling a method [] on an object
|
|
# para chamar o método [] de um objeto
|
|
array.[] 0 #=> 1
|
|
array.[] 12 #=> nil
|
|
|
|
# From the end
|
|
# a partir do final
|
|
array[-1] #=> 5
|
|
|
|
# With a start and end index
|
|
# Com um índice de começo e fim
|
|
array[2, 4] #=> [3, 4, 5]
|
|
|
|
# Or with a range
|
|
# Ou com um intervalo de valores
|
|
array[1..3] #=> [2, 3, 4]
|
|
|
|
# Add to an array like this
|
|
# Adicionar a um array como este
|
|
array << 6 #=> [1, 2, 3, 4, 5, 6]
|
|
|
|
# Hashes are Ruby's primary dictionary with keys/value pairs.
|
|
# Hashes são dicionário com um par de chave(key)/valor(value)
|
|
# Hashes are denoted with curly braces:
|
|
# Hashes são simbolizados com chaves "{}"
|
|
hash = {'color' => 'green', 'number' => 5}
|
|
hash = {'cor' => 'verde', 'numero' => 5}
|
|
|
|
hash.keys #=> ['cor', 'numero']
|
|
|
|
# Hashes can be quickly looked up by key:
|
|
# Hashes podem ser rapidamente pesquisado pela chave (key)
|
|
hash['cor'] #=> 'verde'
|
|
hash['numero'] #=> 5
|
|
|
|
# Asking a hash for a key that doesn't exist returns nil:
|
|
# Procurar em um hash por uma chave que não existe retorna nil:
|
|
hash['nothing here'] #=> nil
|
|
hash['nada aqui'] #=> nil
|
|
|
|
# Iterate over hashes with the #each method:
|
|
# Interar sobre hashes com o método #each:
|
|
hash.each do |k, v|
|
|
puts "#{k} is #{v}"
|
|
end
|
|
|
|
hash.each do |k, v|
|
|
puts "#{k} é #{v}"
|
|
end
|
|
|
|
# Since Ruby 1.9, there's a special syntax when using symbols as keys:
|
|
# Desde o Ruby 1.9, temos uma sintaxe especial quando usamos simbolos como chaves (keys)
|
|
|
|
new_hash = { defcon: 3, action: true}
|
|
novo_hash = { defcon: 3, acao: true}
|
|
|
|
new_hash.keys #=> [:defcon, :action]
|
|
novo_hash.keys #=> [:defcon, :acao]
|
|
|
|
# Tip: Both Arrays and Hashes are Enumerable
|
|
# Dica: Tanto Arrays quanto Hashes são Enumerable
|
|
# They share a lot of useful methods such as each, map, count, and more
|
|
# Eles compartilham um monte de métodos úteis como each, map, count e mais
|
|
|
|
# Control structures
|
|
# Estruturas de controle
|
|
|
|
if true
|
|
"if statement"
|
|
elsif false
|
|
"else if, optional"
|
|
else
|
|
"else, also optional"
|
|
end
|
|
|
|
if true
|
|
"Se verdadeiro"
|
|
elsif false
|
|
"else if, opicional"
|
|
else
|
|
"else, também é opicional"
|
|
end
|
|
|
|
for counter in 1..5
|
|
puts "iteration #{counter}"
|
|
end
|
|
|
|
for contador in 1..5
|
|
puts "interação #{contador}"
|
|
end
|
|
#=> contador 1
|
|
#=> contador 2
|
|
#=> contador 3
|
|
#=> contador 4
|
|
#=> contador 5
|
|
|
|
# HOWEVER
|
|
# PORÉM
|
|
# No-one uses for loops
|
|
# Ninguém usa para loops
|
|
# Use `each` instead, like this:
|
|
# Use "each" em vez, dessa forma:
|
|
|
|
(1..5).each do |counter|
|
|
puts "iteration #{counter}"
|
|
end
|
|
|
|
(1..5).each do |contador|
|
|
puts "interação #{contador}"
|
|
end
|
|
#=> contador 1
|
|
#=> contador 2
|
|
#=> contador 3
|
|
#=> contador 4
|
|
#=> contador 5
|
|
|
|
counter = 1
|
|
while counter <= 5 do
|
|
puts "iteration #{counter}"
|
|
counter += 1
|
|
end
|
|
|
|
contador = 1
|
|
while contador <= 5 do
|
|
puts "interação #{contador}"
|
|
contador += 1
|
|
end
|
|
#=> contador 1
|
|
#=> contador 2
|
|
#=> contador 3
|
|
#=> contador 4
|
|
#=> contador 5
|
|
|
|
grade = 'B'
|
|
|
|
case grade
|
|
when 'A'
|
|
puts "Way to go kiddo"
|
|
when 'B'
|
|
puts "Better luck next time"
|
|
when 'C'
|
|
puts "You can do better"
|
|
when 'D'
|
|
puts "Scraping through"
|
|
when 'F'
|
|
puts "You failed!"
|
|
else
|
|
puts "Alternative grading system, eh?"
|
|
end
|
|
|
|
grau = 'B'
|
|
|
|
case grau
|
|
when 'A'
|
|
puts "Um longo caminho a percorrer pequeno gafanhoto"
|
|
when 'B'
|
|
puts "Melhor sorte da próxima vez"
|
|
when 'C'
|
|
puts "Você pode fazer melhor"
|
|
when 'D'
|
|
puts "Scraping through"
|
|
when 'F'
|
|
puts "Você falhou"
|
|
else
|
|
puts "Alternative grading system, eh?"
|
|
end
|
|
|
|
# Functions
|
|
# Funções
|
|
|
|
def dobrar(x)
|
|
x * 2
|
|
end
|
|
|
|
# Functions (and all blocks) implcitly return the value of the last statement
|
|
# Funções (e todos os blocos) retornam implicitamente o valor da última linha
|
|
double(2) #=> 4
|
|
dobrar(2) #=> 4
|
|
|
|
# Parentheses are optional where the result is unambiguous
|
|
# Parênteses são opicionais onde o resultado é claro
|
|
double 3 #=> 6
|
|
dobrar 3 #=> 6
|
|
|
|
double double 3 #=> 12
|
|
dobrar dobrar 3 #=> 12
|
|
|
|
def sum(x,y)
|
|
x + y
|
|
end
|
|
|
|
def somar(x,y)
|
|
x + y
|
|
end
|
|
|
|
# Method arguments are separated by a comma
|
|
# Argumentos de métodos são separados por uma virgula
|
|
sum 3, 4 #=> 7
|
|
somar 3, 4 #=> 7
|
|
|
|
somar somar(3,4), 5 #=> 12
|
|
|
|
# yield
|
|
# All methods have an implicit, optional block parameter
|
|
# Todos os métodos possuem implicitamente um paramêntro opcional que é um bloco
|
|
# it can be called with the 'yield' keyword
|
|
# ele pode ser chamado com a palavra chave 'yield'
|
|
|
|
def surround
|
|
puts "{"
|
|
yield
|
|
puts "}"
|
|
end
|
|
|
|
surround { puts 'hello world' }
|
|
|
|
|
|
def ao_redor
|
|
puts "{"
|
|
yield
|
|
puts "}"
|
|
end
|
|
|
|
ao_redor { puts 'Olá mundo' }
|
|
|
|
# {
|
|
# Olá mundo
|
|
# }
|
|
|
|
|
|
# Define a class with the class keyword
|
|
# Define uma classe com a palavra chave 'class'
|
|
class Human
|
|
|
|
# A class variable. It is shared by all instances of this class.
|
|
@@species = "H. sapiens"
|
|
|
|
# Basic initializer
|
|
def initialize(name, age=0)
|
|
# Assign the argument to the "name" instance variable for the instance
|
|
@name = name
|
|
# If no age given, we will fall back to the default in the arguments list.
|
|
@age = age
|
|
end
|
|
|
|
# Basic setter method
|
|
def name=(name)
|
|
@name = name
|
|
end
|
|
|
|
# Basic getter method
|
|
def name
|
|
@name
|
|
end
|
|
|
|
# A class method uses self to distinguish from instance methods.
|
|
# It can only be called on the class, not an instance.
|
|
def self.say(msg)
|
|
puts "#{msg}"
|
|
end
|
|
|
|
def species
|
|
@@species
|
|
end
|
|
|
|
end
|
|
|
|
|
|
class Humano
|
|
|
|
# Uma variavel de classe. Ela é compartilhada por todas as instancias dessa classe
|
|
@@especies = "H. sapiens"
|
|
|
|
# Inicialização básica (contructor)
|
|
def initialize(nome, idade=0)
|
|
# Atribui o argumento para a variavel de instacia "nome" do objeto
|
|
@nome = nome
|
|
# Se a idade não for passada, nós definimos um valor padrão na lista de argumentos
|
|
@idade = idade
|
|
end
|
|
|
|
# Método básico para atribuir valor
|
|
def nome=(nome)
|
|
@nome = nome
|
|
end
|
|
|
|
# Método básico de resgatar valor
|
|
def nome
|
|
@nome
|
|
end
|
|
|
|
# Um método de classe usa a palavra chave self para se defenciar dos métodos de instancia.
|
|
# Ele só pode ser chamado na classe, não na instancia
|
|
def self.diz(msg)
|
|
puts "#{msg}"
|
|
end
|
|
|
|
def especies
|
|
@@especies
|
|
end
|
|
|
|
end
|
|
|
|
|
|
# Instantiate a class
|
|
# Instaciando uma classe
|
|
jim = Human.new("Jim Halpert")
|
|
jim = Humano.new("Jim Halpert")
|
|
|
|
dwight = Human.new("Dwight K. Schrute")
|
|
dwight = Humano.new("Dwight K. Schrute")
|
|
|
|
# Let's call a couple of methods
|
|
# Vamos chamar um par de métodos
|
|
jim.species #=> "H. sapiens"
|
|
jim.especies #=> "H. sapiens"
|
|
|
|
jim.name #=> "Jim Halpert"
|
|
jim.nome #=> "Jim Halpert"
|
|
|
|
jim.name = "Jim Halpert II" #=> "Jim Halpert II"
|
|
jim.nome = "Jim Halpert II" #=> "Jim Halpert II"
|
|
|
|
jim.name #=> "Jim Halpert II"
|
|
jim.nome #=> "Jim Halpert II"
|
|
|
|
dwight.species #=> "H. sapiens"
|
|
dwight.especies #=> "H. sapiens"
|
|
|
|
dwight.name #=> "Dwight K. Schrute"
|
|
dwight.nome #=> "Dwight K. Schrute"
|
|
|
|
# Call the class method
|
|
# Chamar o método de classe
|
|
Human.say("Hi") #=> "Hi"
|
|
Humano.diz("Oi") #=> "Oi"
|
|
|
|
# Class also is object in ruby. So class can have instance variables.
|
|
# Uma classe também é objeto em Ruby. Então uma classe pode possuir um variavel de instancia
|
|
# Class variable is shared among the class and all of its descendants.
|
|
# Variavies de classe são compartilhadas entre a classe e todos os seus descendentes.
|
|
|
|
# base class
|
|
class Human
|
|
@@foo = 0
|
|
|
|
def self.foo
|
|
@@foo
|
|
end
|
|
|
|
def self.foo=(value)
|
|
@@foo = value
|
|
end
|
|
end
|
|
|
|
|
|
# Classe base
|
|
class Humano
|
|
@@foo = 0
|
|
|
|
def self.foo
|
|
@@foo
|
|
end
|
|
|
|
def self.foo=(value)
|
|
@@foo = value
|
|
end
|
|
end
|
|
|
|
# classe filha
|
|
class Trabalhador < Humano
|
|
end
|
|
|
|
Human.foo # 0
|
|
Humano.foo # 0
|
|
Worker.foo # 0
|
|
Trabalhador.foo # 0
|
|
|
|
Human.foo = 2 # 2
|
|
Humano.foo = 2 # 2
|
|
Worker.foo # 2
|
|
Trabalhador.foo # 2
|
|
|
|
# Class instance variable is not shared by the class's descendants.
|
|
# Uma variavel de instancia não é compartilhada por suas classes decendentes.
|
|
|
|
class Human
|
|
@bar = 0
|
|
|
|
def self.bar
|
|
@bar
|
|
end
|
|
|
|
def self.bar=(value)
|
|
@bar = value
|
|
end
|
|
end
|
|
|
|
class Humano
|
|
@bar = 0
|
|
|
|
def self.bar
|
|
@bar
|
|
end
|
|
|
|
def self.bar=(value)
|
|
@bar = value
|
|
end
|
|
end
|
|
|
|
class Doctor < Human
|
|
end
|
|
|
|
class Doutor < Humano
|
|
end
|
|
|
|
Humano.bar # 0
|
|
Doutor.bar # nil
|
|
|
|
```
|