Methods za Ruby hufafanuliwa kwa def...end. Ruby ina ushughulikiaji wa arguments unaobadilika na wenye uwazi — default values, keyword arguments, splat (*) kwa arguments zinazobadilika, na blocks — pamoja na desturi kwamba expression ya mwisho ndiyo thamani ya kurudi ya kiimplicit.
()
a + b
add(, )
()
Methods za Ruby hurudisha expression ya mwisho iliyokokotolewa kiotomatiki — mara chache unaandika return (inatumika tu kwa early returns). Hii ni ya kiidiomu.
# default arguments
def greet(name, greeting = "Hello")
"#{greeting}, #{name}"
end
greet("Ann") # "Hello, Ann"
greet("Ann", "Hi") # "Hi, Ann"
# KEYWORD arguments (clearer, order-independent) — common in modern Ruby
def create_user(name:, age: 0, role: :user)
# name is required (no default); age/role optional
end
create_user(name: "Ann", role: :admin) # pass by keyword — readable
Keyword arguments (name:) ni Ruby ya kisasa ya kiidiomu — zinafanya calls kujieleza zenyewe na zisizotegemea mpangilio.
def sum(*numbers) # * collects extra positional args into an array
numbers.sum
end
sum(1, 2, 3, 4) # 10
def config(**options) # ** collects keyword args into a hash
options[:timeout]
end
config(timeout: 30, retries: 3)
*args hukusanya positional arguments zinazobadilika ndani ya array; **options hukusanya keyword arguments ndani ya hash.
def valid?(x) # ? convention → returns a boolean (predicate method)
x > 0
end
def process!(data) # ! convention → modifies in place / is "dangerous"
data.map!(&:upcase)
end
Kanuni za kupatia majina: methods zinazoishia kwa ? hurudisha booleans (predicates), na ! inaonyesha toleo la kuharibu/in-place au la "hatari".
Methods ni vitalu vya ujenzi vya tabia katika Ruby, na kuelewa ushughulikiaji unaobadilika na wenye uwazi wa arguments na desturi za Ruby ni maarifa muhimu ya kila siku.
Vipengele kadhaa ni vya kipekee vya Ruby na vinastahili kujua: implicit return (methods hurudisha expression ya mwisho iliyokokotolewa, hivyo return mara chache huandikwa — Ruby ya kiidiomu inategemea hili), keyword arguments (name: — njia ya kisasa, ya kiidiomu ya kuandika method calls wazi, zinazojieleza, zisizotegemea mpangilio), na splat arguments (*args/**options kwa idadi inayobadilika ya arguments).
Muhimu sawa ni kanuni za kupatia majina — methods zinazoishia kwa ? ni predicates zinazorudisha booleans (valid?, empty?), na methods zinazoishia kwa ! ni matoleo ya kuharibu/in-place au ya "hatari" (map!, sort!) — ambazo zimeenea katika Ruby na Rails na huwasiliana tabia ya method kwa mtazamo mmoja (kujua kwamba ! kawaida inamaanisha "hubadilisha in place" ni muhimu kwa kuepuka mabadiliko yasiyotarajiwa).
Kuelewa jinsi ya kufafanua methods kwa arguments zinazobadilika za Ruby (defaults, keywords, splats), idiom ya implicit-return, na kanuni za kupatia majina za ?/! ni msingi wa kuandika na kusoma Ruby ya kiidiomu — vipengele hivi na desturi hizi hujitokeza mara kwa mara, na kuvifahamu (hasa keyword arguments kwa APIs safi na kanuni za ?/! kwa kuelewa tabia ya method) ni maarifa muhimu, yanayotumika mara kwa mara kwa uendelezaji bora wa Ruby.