@@ -1,132 +1,132 @@ - - !^sidebar - Concerning Commercial Uses of the (Poignant) Guide: > - - This book is released under a Creative Commons license which allows unlimited commercial - use of this text. Basically, this means you can sell all these bootleg copies of my book - and keep the revenues for yourself. I trust my readers (and the world around them) to rip me off. - To put out some crappy Xerox edition with that time-tested clipart of praying hands on the cover. - - - Guys, the lawsuits just ain't worth the headache. So I'm just going to straight up endorse - authorized piracy, folks. Anybody who wants to read the book should be able to read it. - Anybody who wants to market the book or come up with special editions, I'm flattered. - - - Why would I want the $$$? IGNORE ALL OTHER SIDEBARS: I've lost the will to be a rich slob. - Sounds inhuman, but I like my little black-and-white television. Also my hanging plastic flower lamp. - I don't want to be a career writer. Cash isn't going inspire me. Pointless. - - - So, if money means nothing to the lucky stiff, why rip me off when you could co-opt shady - business practices to literally crush my psyche and leave me wheezing in some sooty iron lung? - Oh, and the irony of using my own works against me! Die, Poignant Boy! - - - To give you an idea of what I mean, here are a few underhanded concepts that could seriously - kill my willpower and force me to reconsider things like existence. - - - *IDEA ONE: BIG TOBACCO* - - - Buy a cigarette company. Use my cartoon foxes to fuel an aggressive ad campaign. - Here's a billboard for starters: - - - !i/the.foxes-0a.png(Addiction is like Pokemon!)! - - - Make it obvious that you're targeting children and the asthmatic. Then, once you've got - everyone going, have the *truth* people do an expose on me and my farm of inky foxes. - - - bq. *Sensible Hipster Standing on Curb in Urban Wilderness*: He calls himself the lucky stiff. - - - bq. (Pulls aside curtain to reveal grey corpse on a gurney.) - - - bq. *Hipster*: Some stiffs ain't so lucky. - - - bq. (Erratic zoom in. Superimposed cartoon foxes for subliminal Willy Wonka mind trip.) - - - Yo. Why you gotta dis Big Smokies like dat, Holmes? - - - *IDEA TWO: HEY, FIRING SQUAD* - - - Like I said, start selling copies of my book, but corrupt the text. These altered copies - would contain numerous blatant (and libelous) references to government agencies, such as the - U.S. Marshals and the Pentagon. You could make me look like a complete traitor. Like I have - all these plans to, you know, kill certain less desirable members of the U.S. Marshals or - the Pentagon. - - - Not that there are any less desirable members of the U.S. Marshals or the Pentagon. Yeah, - I didn't mean it like that. - - - Oh, crap. - - - Oh, crap. Oh, crap. Oh, crap. - - - Turn off the lights. Get down. - - - *IDEA THREE: BILLBOARDS, PART II* - - - How about making fun of asthmatics directly? - - - !i/the.foxes-0b.png(Call it a puffer! ROFL!)! - - - *IDEA FOUR: ALEC BALDWIN* - - - Adapt the book into a movie. And since, you know, I'm a character in this book, - you could get someone like Alec Baldwin to play me. Someone who's at a real lowpoint - in his career. - - - You could make it seem like I did tons of drugs. Like I was insane to work with. - Like I kept firing people and locking them in the scooter room and making them - wear outfits made of bread. Yeah, like I could actually be _baking_ people into - the outfits. - - - You could have this huge mold that I strap people into. Then, I pour all the dough - on them and actually bake them until the bread has risen and they've almost died. - And when the television crews come and I'm on Good Morning America, they'll ask, - "So, how many people have you employed in the production of your book?" And I'd - respond, "A baker's dozen!" and erupt into that loud maniacal laughing that would - force audience members to cup their hands over their ears. - - - Of course, in the throes of my insanity, I would declare war on the world. The - bread people would put up quite a fight. Until the U.S. Marshals (or the Pentagon) - engineer a giant robotic monkey brain (played by Burt Lancaster) to come after me. - - - Here's where you'll make me look completely lame. Not only will I sacrifice all of - the bread people (the Starchtroopers) to save myself, not only will I surrender to - the great monkey brain like a coward, but when I narrowly escape, I'll yell at the - audience. Screaming insistently that it's _MY_ movie and no one should see it any - more, I'll rip the screen in half and the film projector will spin with its reel - flapping in defeat. And that will be the end of the movie. People will be _so_ - pissed. - - - Now, I've got to thinking. See, and actually, Alec Baldwin did a decent voiceover - in _The Royal Tenenbaums_. His career might be okay. You might not want to use him. - He might not do it. - - - Tell ya what. I'll play the part. I've made a career out of lowpoints. - + - !^sidebar + A respeito do uso comercial do (Poignant) Guide: > + + Este livro foi lançado sob a licensa Creative Commons que permite uso comercial ilimitado + deste texto. Basicamente, isto significa que você pode vender todas cópias piratas do meu livro + e ficar com todo o lucro pra você. Eu confio nos meus leitores (e no mundo ao redor deles) para me passar pra trás. + E colocar uma edição em Xerox com aquele clipart das mãos unidas rezando, que nós conhecemos, na capa. + + + Guys, the lawsuits just ain't worth the headache. So I'm just going to straight up endorse + authorized piracy, folks. Anybody who wants to read the book should be able to read it. + Anybody who wants to market the book or come up with special editions, I'm flattered. + + + Why would I want the $$$? IGNORE ALL OTHER SIDEBARS: I've lost the will to be a rich slob. + Sounds inhuman, but I like my little black-and-white television. Also my hanging plastic flower lamp. + I don't want to be a career writer. Cash isn't going inspire me. Pointless. + + + So, if money means nothing to the lucky stiff, why rip me off when you could co-opt shady + business practices to literally crush my psyche and leave me wheezing in some sooty iron lung? + Oh, and the irony of using my own works against me! Die, Poignant Boy! + + + To give you an idea of what I mean, here are a few underhanded concepts that could seriously + kill my willpower and force me to reconsider things like existence. + + + *IDEA ONE: BIG TOBACCO* + + + Buy a cigarette company. Use my cartoon foxes to fuel an aggressive ad campaign. + Here's a billboard for starters: + + + !i/the.foxes-0a.png(Addiction is like Pokemon!)! + + + Make it obvious that you're targeting children and the asthmatic. Then, once you've got + everyone going, have the *truth* people do an expose on me and my farm of inky foxes. + + + bq. *Sensible Hipster Standing on Curb in Urban Wilderness*: He calls himself the lucky stiff. + + + bq. (Pulls aside curtain to reveal grey corpse on a gurney.) + + + bq. *Hipster*: Some stiffs ain't so lucky. + + + bq. (Erratic zoom in. Superimposed cartoon foxes for subliminal Willy Wonka mind trip.) + + + Yo. Why you gotta dis Big Smokies like dat, Holmes? + + + *IDEA TWO: HEY, FIRING SQUAD* + + + Like I said, start selling copies of my book, but corrupt the text. These altered copies + would contain numerous blatant (and libelous) references to government agencies, such as the + U.S. Marshals and the Pentagon. You could make me look like a complete traitor. Like I have + all these plans to, you know, kill certain less desirable members of the U.S. Marshals or + the Pentagon. + + + Not that there are any less desirable members of the U.S. Marshals or the Pentagon. Yeah, + I didn't mean it like that. + + + Oh, crap. + + + Oh, crap. Oh, crap. Oh, crap. + + + Turn off the lights. Get down. + + + *IDEA THREE: BILLBOARDS, PART II* + + + How about making fun of asthmatics directly? + + + !i/the.foxes-0b.png(Call it a puffer! ROFL!)! + + + *IDEA FOUR: ALEC BALDWIN* + + + Adapt the book into a movie. And since, you know, I'm a character in this book, + you could get someone like Alec Baldwin to play me. Someone who's at a real lowpoint + in his career. + + + You could make it seem like I did tons of drugs. Like I was insane to work with. + Like I kept firing people and locking them in the scooter room and making them + wear outfits made of bread. Yeah, like I could actually be _baking_ people into + the outfits. + + + You could have this huge mold that I strap people into. Then, I pour all the dough + on them and actually bake them until the bread has risen and they've almost died. + And when the television crews come and I'm on Good Morning America, they'll ask, + "So, how many people have you employed in the production of your book?" And I'd + respond, "A baker's dozen!" and erupt into that loud maniacal laughing that would + force audience members to cup their hands over their ears. + + + Of course, in the throes of my insanity, I would declare war on the world. The + bread people would put up quite a fight. Until the U.S. Marshals (or the Pentagon) + engineer a giant robotic monkey brain (played by Burt Lancaster) to come after me. + + + Here's where you'll make me look completely lame. Not only will I sacrifice all of + the bread people (the Starchtroopers) to save myself, not only will I surrender to + the great monkey brain like a coward, but when I narrowly escape, I'll yell at the + audience. Screaming insistently that it's _MY_ movie and no one should see it any + more, I'll rip the screen in half and the film projector will spin with its reel + flapping in defeat. And that will be the end of the movie. People will be _so_ + pissed. + + + Now, I've got to thinking. See, and actually, Alec Baldwin did a decent voiceover + in _The Royal Tenenbaums_. His career might be okay. You might not want to use him. + He might not do it. + + + Tell ya what. I'll play the part. I've made a career out of lowpoints. + lang-pt/poignant-17.yml @@ -1,328 +1,327 @@ - - The Continued Story of My Daughter's Organ Instructor: > - - I know you may be alarmed to hear that I have a daughter. You think my writing is indicative - of a palsied or infantile mind. Well, please rest. I don't have a daughter. - But I can't let that stop me from sorting out her musical training. - - - As I was related these elaborate histories of the planet Endertromb, I found myself - wandering through hallways, running my fingertips along the tightly buttoned sofas - and soaking myself in the saturated bellowings of the pipes, as played by my daughter's - organ instructor. His notes resounded so deep and hollow in the walls of his manor - that I began to casually mistake them for an ominous silence, and found it even - easier to retreat into deep space with my thoughts. To think upon the ancient - planet and its darker philosophies: its flesh temples, tanned from the dermal remains - of its martyrs; its whale cartels, ingesting their enemies and holding them within for - decades, dragging them up and down the staircases of ribs; its poison fogs and its - painful doorways; and, the atrocious dynasties - of The Originals, the species which claims fathership to all of the intellegent beings - across the universe. - - - But, eventually, I'd hear those pipes of a higher octave sing and I'd be back in the very same - breezy afternoon where I'd left. - - - How interesting that even the breeze of our planet is quite a strange thing to some - outsiders. For he had also told me of the travellers from Rath-d, who ventured to Earth - five centuries ago, but quickly dissipated in our air currents since they and their crafts - and their armor were all composed of charcoal. - - - I had sat at the organ, listening to his faint tales of his colony, while he punctuated his - symphonies to greater volumes and the story would disappear for awhile, until the coda came back around. - He spoke of he and his brothers piling into the hollow of his mother's tail and tearing the - waxy crescent tissue from the inner wall. Juicy and spongy and syrupy soap which bleached - their mouths and purged their esophagus as it went down. They chewed and chomped the stuff - and it foamed. After they ate, they blew bubbles at each other, each bubble filled with a dense - foam, which they slept upon. And early in the morning, when mother opened her tail again, she watched - serenely as her babies lay cradled in the stew of dark meatballs and sweet, sticky froth. - - - He spelled out all the tastes of Endertromb. Of their salmon's starchy organs, which cooked - into a pasta, and its eyes which melted into rich cream. Of their buttermelon with tentacles. - And he was just beginning to appreciate the delicacies as a child, only to be lifted from a - schoolyard by a pair of upright pygmy elephants who reached at him, through the heavens, and - snatched upon his collar with a vast length of crane. - - - They transplanted him on Earth, led him from their craft, trumpeting their snouts loudly for the city of - Grand Rapids to hear, then left, weeping and embracing each other. - - - "Mas, estranhamente (em-pithy-dah), Eu aprendi, toquei (pon-shoo) nos órgãos no meu planeta - (oth-rea) natal," ele disse. - - - O instrutor de órgão da minha filha fala essas palavras extras que você vê em parênteses. Quem é - que sabe se é sua língua nativa ou seu soluço sonoro. Ele mantém outro - traço de Endertromb: ele tem doze nomes. - - - "Não, (wen-is-wen)," ele disse. "Eu tenho um nome (im-apalla) que é dito (iff) - de muitas-muitas maneiras difentes." - - - Eu o chamo de Paij-ree nas manhãs e Paij-plo de tarde. - Já que estou escrevendo de dia, o chamarei de Paij-ree aqui. - - - h3. Protetores de Ouvido Múrmurio-Free - - - !>i/my.daughters.organ-1.gif(Alien at the keys.)! - - - Então eu disse a Paij-ree, "Paij-ree, eu estou escrevendo um livro. Para ensinar ao mundo Ruby." - - - "Oh, (pill-nog-pill-yacht) bacana," ele disse. Ele conhece Ruby há mais tempo que eu, mas mesmo assim: - _Eu_ serei o instrutor de Ruby da minha filha. - - - E eu disse, "Paij-ree, você está no livro. E as estórias do seu planeta." Eu falo com ele como - se ele fosse o E.T. Eu não sei porquê. Como o que disse em seguida, "E daí talvez algum dia - você possa ir pra casa pro seu pai e pra sua mãe!" - - - Ele replicou, "(pon-shoo) (pon-shoo) (em-pithy-dah)." Que é o jeito dele de expressar - out loud seu silêncio e temor. - - - Ele queria ver o que eu havia escrito, então eu mostrei a ele este pequeno método que escrevi pra você. - - - <pre> - def limpar_murmurios_de( frase ) - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - end - </pre> - - - "Viu o que isto faz, Paij-ree? Qualquer Smotchkkiss velho pode usar este método - pra remover todas as o take all the incoherent babblings out of your speaking," I said. - - - E eu alimentei o método com algo que ele havia dito mais cedo. - - - <pre> - o_que_ele_disse = "Mas, estranhamente (em-pithy-dah), - Eu aprendi, toquei (pon-shoo) em órgãos no meu planeta - (oth-rea) natal." - limpar_murmurios_de( o_que_ele_disse ) - print o_que_ele_disse - </pre> - - - E saiu de certa forma uma frase mais clara. - - - <pre> - Mas, estranhamente , - Eu aprendi, toquei em órgãos no meu planeta - natal. - </pre> - - - "You shouldn't use that (wary-to) while loop," he said. "There are lovelier, (thopt-er), - gentler ways." - - - No método @limpar_murmurios_de@, estou basicamente procurando por abre parênteses. Quando eu - encontrou um, eu procuro um fecha parênteses na sequencia. Uma vez que tenha encontrado ambos, eu troco - eles e seu conteúdo por uma string vazia. O loop @while@ continua até que todos os parênteses se acabem. - Os murmúrios são removidos e o método termina. - - - "Agora olhando este método," eu disse. "Eu vejo que há alguns aspectos confusos - e outras coisas que eu poderia ter feito melhor." Por favor não me olhe estranho por seu professor - ter escrito este código. Eu acho certo the mostrar algumas técnicas sloppy techniques - pra te ajudar to help you work through them with me. Então vamos. - - - Okay, *Aspecto confuso No. 1*: Este método limpa uma string. Mas e se nós acidentalmente - dermos a ele um @File@? Ou um número? O que acontece? E se rodarmos @limpar_murmurios_de( 1 )@? - - - Se nós dermos ao @limpar_murmurios_de@ o número 1, o Ruby irá imprimir o seguinte e depois sair. - - - <pre> - NoMethodError: undefined method `include?' for 1:Fixnum - from (irb):2:in `limpar_murmurios_de' - from (irb):8 - </pre> - - - O que você vê aquiere is a rather twisted and verbose (but at times very helpful) little fellow - called the *backtrace*. He's a wound-up policeman who, ao menor sinal de problema, - imediatamente apreende todo e qualquer suspeito, os põe contra a parede all e lê os direitos deles - tão rapidamente que ninguém consegue ouvir tudo. Mas está claro que há - um problema. E, é claro, tudo não passou de um mal entendido, certo? - - - Quando o Ruby ler pra você esses direitos de Miranda, preste atenção no começo. A primeira linha - é quase sempre tudo que você precisa. Nessa primeira linha está contido a mensagem essencial. E ali - em cima, a primeira linha está nos dizendo que não há método @include?@ para o número 1. - Lembra, quando estávamos conversando sobre o método @reverse@ no capítulo anterior? Naquela hora, eu disse, - "*vários métodos só estão disponíveis com certos tipos de valores*." Ambos @reverse@ e - @include?@ são métodos que funcionam com strings mas são sem sentido e indisponíveis para números. - - - Pra deixar claro: o método tenta usar o número. O método vai começar com @frase@ valendo 1. - Então, ele chega na segunda linha: @while frase.include? '('@. Números não têm método @include?@. - Great, the backtrace has shown us where the problem is. Eu não esperava que alguém fosse passar - um número, então estou usando métodos que não funcionam com números. - - - *See, this is just it.* Our method is its own little pocket tool, right? It acts as its own - widget independent of anything else. To anyone out there using the @limpar_murmurios_de@ - method, should they pass in a number, they'll be tossed this panic message that doesn't - make sense to them. Eles serão convidados a bisbilhotar o métodd, o que realmente não é - trabalho deles. Eles não sabem como se virar lá dentro. - - - Felizmente, nós podemos inserir nossos próprios erros, nossas próprias *exceções*, o que pode fazer mais - sentido a algum desavisado que dê um objeto errado pra ser limpo. - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :include? - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - end - </pre> - - - Desta vez, se passarmos um número (de novo, o número 1), teremos algo mais sensato. - - - <pre> - ArgumentError: não posso limpar os múrmurios de um(a) Fixnum - from (irb):3:in `limpar_murmurios_de' - from (irb):12 - </pre> - - - O método @respond_to?@ é realmente bacana e eu imploro que você nunca se esqueça dele. - O @respond_to?@ checa qualquer objeto para garantir que ele tenha um certo método. Ele então retorna - com @true@ o @false@. No caso acima, é checado se o objeto @frase@ recebido tem um método - @include?@. Se nenhum método @include?@ for encontrado, então causamos o erro. - - - Você deve estar pensando por que eu usei um símbolo com o @respond_to?@. Eu usei um símbolo @:include?@ - invés da string @'include?'@. Na verdade, ambos funcionarão com o @respond_to?@. - - - Geralmente símbolos são usados quando você está passando o nome de um método ou qualquer outro construtor. - É mais eficiente, chama mais atenção. O @respond_to?@ pergunta ao Ruby to look inside itself - and see if a method is available. Estamos conversando com o Ruby, então o símbolo helps denote that. - Não é grande coisa, Ruby só reconhece símbolos mais rapidamente que strings. - - - Agora, *Aspecto Confuso No. 2*: Você notou como nosso método modifica a frase? - - - <pre> - algo_dito = "Uma (gith) espaçonave." - limpar_murmurios_de( algo_dito ) - print algo_dito - </pre> - - - Você notou isso? Na primeira linha do código acima, a variável @algo_dito@ - contém a string @"Uma espaçonave (gith)."@. Mas, depois de invocar o método, na terceira - linha, nós imprimimos a variável @algo_dito@ e nesse momemento ela contém a string limpa - string @"Uma espaçonave."@. - - - Como isso funciona? Como o método modifica a string? Ele não deveria fazer uma cópia - da string antes de modificá-la? - - - Sim, absolutamente, ele deveria! *É falta de educação modificar strings daquele jeito.* Nós usamos @gsub@ e - @gsub!@ no capítulo passado. Você se lembra qual destes dois métodos é um *método destrutivo*, - que modifica strings diretamente? - - - Ou nós chamamos este método de @limpar_murmurios_de!@ (cortesia a todos os colegas bacanas - por aí que podem vir a usar este método) ou modificar o método para trabalhar em uma cópia - da string invés da coisa real. O que é uma modificação muito fácil! Nós só precisamos dar - um @dup@ na string. - - - <pre> - def limpar_murmurios_de( frase ) - unless frase.respond_to? :include? - raise ArgumentError, - "não posso limpar os múrmurios de um(a) #{ frase.class }" - end - frase = frase.dup - while frase.include? '(' - abre = frase.index( '(' ) - fecha = frase.index( ')', abre ) - frase[abre..fecha] = '' if fecha - end - frase - end - </pre> - - - O método @dup@ faz uma cópia de qualquer objeto. Veja a linha que adicionamos separada: - - - <pre> - frase = frase.dup - </pre> - - - Que linha de código peculiar. Como que @frase@ vira uma cópia de @frase@? - Ela se apaga? O que acontece com a @frase@ original? Ela desaparece? - - - Lembre que variáveis são como apelidos. Quando você vê @frase = "Uma (gith) espaçonave."@, - você o Ruby criando uma string e então dando um apelido a essa string. - - - Do mesmo modo, quando você vê @frase = frase.dup@, você ve o Ruby criando uma nova string e então - dando um apelido a essa string. Iso é útil dentro do seu método porque agora @frase@ é - um pelido para uma nova cópia da string que você pode usar seguramente *sem modificar a string - que foi passada pro método*. - - - Você vai ver muitos examplos de nomes de variáveis seudo reusados. - - - <pre> - x = 5 - x = x + 1 - # x agora é igual a 6 - - y = "Endertromb" - y = y.length - # y agora é igual a 10 - - z = :include? - z = "a string".respond_to? z - # z agora é igual a true - </pre> - - - E, sim, algumas vezes objetos desaparecem. *Se você não consege pegar um objeto por uma váriavel, então - o Ruby vai entender que você já terminou com ele e vai se livrar dele.* Periodicamente, o Ruby envia seu - *garbage collector (coletor de lixo)* pra libertar estes objetos. Todo objeto é mantido na memória do - seu computador até que o coletor de lixo se livre dele. - - + - A continuação da história do instrutor de órgão da minha filha: > + + Eu sei que você pode estar surpreso em saber que eu tenho uma filha. Você pensa que meu estilo + de escrita indica uma mente imatura ou infantil. Bem, por favor relaxe. Eu não tenho uma filha. + Mas isso não me impede de pensar no treinamento musical dela. + + + Enquanto essas histórias do planeta Endertromb eram relatadas a mim, eu me vi vagando + por corredores, passando as pontas dos meus dedos por sofás fortemente abotoados + e me envolvendo nos gritos saturados dos tubos, enquanto o instrutor de órgão da minha filha + tocava. Suas notas ressoavam tão ocas e profundas nas paredes de sua mansão + que eu comecei a confundí-las com um silêncio nefasto, e achava ainda mais fácil + me recolher ao espaço infinito dos meus pensamentos. Para pensar no planeta ancestral + e suas filosofias obscuras: seus templos carnais, corados com os resíduos dérmicos + dos seus mártires; seus cartéis de baleias, engolindo seus inimigos e prendendo-os por + décadas, arrastando-os para cima e para baixo em suas escadarias de costelas; suas brumas venenosas e + seus portais dolorosos; e, as cruéis dinastias + dos Originais, a espécie que clama paternidade de toda vida inteligente no universo. + + + Mas, eventualmente, eu ouvia aqueles tubos de oitavas mais altas cantar sing e acabava voltando + para a mesma tarde jovial de onde havia saído. + + + É interessando como até a brisa do nosso planeta é uma coisa um tanto estranha para + forasteiros. Ele também me contou sobre viajantes de Rat-d Rath-d, que se aventuraram na Terra + cinco séculos atrás, mas se dissiparam rapidamente nas nossas correntes de ar já que eles, seus equipamentos e + sua armadura eram todos feitos de carvão. + + + I had sat at the organ, listening to his faint tales of his colony, while he punctuated his + symphonies to greater volumes and the story would disappear for awhile, until the coda came back around. + He spoke of he and his brothers piling into the hollow of his mother's tail and tearing the + waxy crescent tissue from the inner wall. Juicy and spongy and syrupy soap which bleached + their mouths and purged their esophagus as it went down. They chewed and chomped the stuff + and it foamed. After they ate, they blew bubbles at each other, each bubble filled with a dense + foam, which they slept upon. And early in the morning, when mother opened her tail again, she watched + serenely as her babies lay cradled in the stew of dark meatballs and sweet, sticky froth. + + + He spelled out all the tastes of Endertromb. Of their salmon's starchy organs, which cooked + into a pasta, and its eyes which melted into rich cream. Of their buttermelon with tentacles. + And he was just beginning to appreciate the delicacies as a child, only to be lifted from a + schoolyard by a pair of upright pygmy elephants who reached at him, through the heavens, and + snatched upon his collar with a vast length of crane. + + + They transplanted him on Earth, led him from their craft, trumpeting their snouts loudly for the city of + Grand Rapids to hear, then left, weeping and embracing each other. + + + "Mas, estranhamente (em-pithy-dah), Eu aprendi, toquei (pon-shoo) nos órgãos no meu planeta + (oth-rea) natal," ele disse. + + + O instrutor de órgão da minha filha fala essas palavras extras que você vê em parênteses. Quem é + que sabe se é sua língua nativa ou seu soluço sonoro. Ele mantém outro + traço de Endertromb: ele tem doze nomes. + + + "Não, (wen-is-wen)," ele disse. "Eu tenho um nome (im-apalla) que é dito (iff) + de muitas-muitas maneiras difentes." + + + Eu o chamo de Paij-ree nas manhãs e Paij-plo de tarde. + Já que estou escrevendo de dia, o chamarei de Paij-ree aqui. + + + h3. Protetores de Ouvido Múrmurio-Free + + + !>i/my.daughters.organ-1.gif(Alien at the keys.)! + + + Então eu disse a Paij-ree, "Paij-ree, eu estou escrevendo um livro. Para ensinar ao mundo Ruby." + + + "Oh, (pill-nog-pill-yacht) bacana," ele disse. Ele conhece Ruby há mais tempo que eu, mas mesmo assim: + _Eu_ serei o instrutor de Ruby da minha filha. + + + E eu disse, "Paij-ree, você está no livro. E as estórias do seu planeta." Eu falo com ele como + se ele fosse o E.T. Eu não sei porquê. Como o que disse em seguida, "E daí talvez algum dia + você possa ir pra casa pro seu pai e pra sua mãe!" + + + Ele replicou, "(pon-shoo) (pon-shoo) (em-pithy-dah)." Que é o jeito dele de expressar + out loud seu silêncio e temor. + + + Ele queria ver o que eu havia escrito, então eu mostrei a ele este pequeno método que escrevi pra você. + + + <pre> + def limpar_murmurios_de( frase ) + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + end + </pre> + + + "Viu o que isto faz, Paij-ree? Qualquer Smotchkkiss velho pode usar este método + pra remover todas as o take all the incoherent babblings out of your speaking," I said. + + + E eu alimentei o método com algo que ele havia dito mais cedo. + + + <pre> + o_que_ele_disse = "Mas, estranhamente (em-pithy-dah), + Eu aprendi, toquei (pon-shoo) em órgãos no meu planeta + (oth-rea) natal." + limpar_murmurios_de( o_que_ele_disse ) + print o_que_ele_disse + </pre> + + + E saiu de certa forma uma frase mais clara. + + + <pre> + Mas, estranhamente , + Eu aprendi, toquei em órgãos no meu planeta + natal. + </pre> + + + "You shouldn't use that (wary-to) while loop," he said. "There are lovelier, (thopt-er), + gentler ways." + + + No método @limpar_murmurios_de@, estou basicamente procurando por abre parênteses. Quando eu + encontrou um, eu procuro um fecha parênteses na sequencia. Uma vez que tenha encontrado ambos, eu troco + eles e seu conteúdo por uma string vazia. O loop @while@ continua até que todos os parênteses se acabem. + Os murmúrios são removidos e o método termina. + + + "Agora olhando este método," eu disse. "Eu vejo que há alguns aspectos confusos + e outras coisas que eu poderia ter feito melhor." Por favor não me olhe estranho por seu professor + ter escrito este código. Eu acho certo the mostrar algumas técnicas sloppy techniques + pra te ajudar to help you work through them with me. Então vamos. + + + Okay, *Aspecto confuso No. 1*: Este método limpa uma string. Mas e se nós acidentalmente + dermos a ele um @File@? Ou um número? O que acontece? E se rodarmos @limpar_murmurios_de( 1 )@? + + + Se nós dermos ao @limpar_murmurios_de@ o número 1, o Ruby irá imprimir o seguinte e depois sair. + + + <pre> + NoMethodError: undefined method `include?' for 1:Fixnum + from (irb):2:in `limpar_murmurios_de' + from (irb):8 + </pre> + + + O que você vê aquiere is a rather twisted and verbose (but at times very helpful) little fellow + called the *backtrace*. He's a wound-up policeman who, ao menor sinal de problema, + imediatamente apreende todo e qualquer suspeito, os põe contra a parede all e lê os direitos deles + tão rapidamente que ninguém consegue ouvir tudo. Mas está claro que há + um problema. E, é claro, tudo não passou de um mal entendido, certo? + + + Quando o Ruby ler pra você esses direitos de Miranda, preste atenção no começo. A primeira linha + é quase sempre tudo que você precisa. Nessa primeira linha está contido a mensagem essencial. E ali + em cima, a primeira linha está nos dizendo que não há método @include?@ para o número 1. + Lembra, quando estávamos conversando sobre o método @reverse@ no capítulo anterior? Naquela hora, eu disse, + "*vários métodos só estão disponíveis com certos tipos de valores*." Ambos @reverse@ e + @include?@ são métodos que funcionam com strings mas são sem sentido e indisponíveis para números. + + + Pra deixar claro: o método tenta usar o número. O método vai começar com @frase@ valendo 1. + Então, ele chega na segunda linha: @while frase.include? '('@. Números não têm método @include?@. + Great, the backtrace has shown us where the problem is. Eu não esperava que alguém fosse passar + um número, então estou usando métodos que não funcionam com números. + + + *See, this is just it.* Our method is its own little pocket tool, right? It acts as its own + widget independent of anything else. To anyone out there using the @limpar_murmurios_de@ + method, should they pass in a number, they'll be tossed this panic message that doesn't + make sense to them. Eles serão convidados a bisbilhotar o métodd, o que realmente não é + trabalho deles. Eles não sabem como se virar lá dentro. + + + Felizmente, nós podemos inserir nossos próprios erros, nossas próprias *exceções*, o que pode fazer mais + sentido a algum desavisado que dê um objeto errado pra ser limpo. + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :include? + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + end + </pre> + + + Desta vez, se passarmos um número (de novo, o número 1), teremos algo mais sensato. + + + <pre> + ArgumentError: não posso limpar os múrmurios de um(a) Fixnum + from (irb):3:in `limpar_murmurios_de' + from (irb):12 + </pre> + + + O método @respond_to?@ é realmente bacana e eu imploro que você nunca se esqueça dele. + O @respond_to?@ checa qualquer objeto para garantir que ele tenha um certo método. Ele então retorna + com @true@ o @false@. No caso acima, é checado se o objeto @frase@ recebido tem um método + @include?@. Se nenhum método @include?@ for encontrado, então causamos o erro. + + + Você deve estar pensando por que eu usei um símbolo com o @respond_to?@. Eu usei um símbolo @:include?@ + invés da string @'include?'@. Na verdade, ambos funcionarão com o @respond_to?@. + + + Geralmente símbolos são usados quando você está passando o nome de um método ou qualquer outro construtor. + É mais eficiente, chama mais atenção. O @respond_to?@ pergunta ao Ruby to look inside itself + and see if a method is available. Estamos conversando com o Ruby, então o símbolo helps denote that. + Não é grande coisa, Ruby só reconhece símbolos mais rapidamente que strings. + + + Agora, *Aspecto Confuso No. 2*: Você notou como nosso método modifica a frase? + + + <pre> + algo_dito = "Uma (gith) espaçonave." + limpar_murmurios_de( algo_dito ) + print algo_dito + </pre> + + + Você notou isso? Na primeira linha do código acima, a variável @algo_dito@ + contém a string @"Uma espaçonave (gith)."@. Mas, depois de invocar o método, na terceira + linha, nós imprimimos a variável @algo_dito@ e nesse momemento ela contém a string limpa + string @"Uma espaçonave."@. + + + Como isso funciona? Como o método modifica a string? Ele não deveria fazer uma cópia + da string antes de modificá-la? + + + Sim, absolutamente, ele deveria! *É falta de educação modificar strings daquele jeito.* Nós usamos @gsub@ e + @gsub!@ no capítulo passado. Você se lembra qual destes dois métodos é um *método destrutivo*, + que modifica strings diretamente? + + + Ou nós chamamos este método de @limpar_murmurios_de!@ (cortesia a todos os colegas bacanas + por aí que podem vir a usar este método) ou modificar o método para trabalhar em uma cópia + da string invés da coisa real. O que é uma modificação muito fácil! Nós só precisamos dar + um @dup@ na string. + + + <pre> + def limpar_murmurios_de( frase ) + unless frase.respond_to? :include? + raise ArgumentError, + "não posso limpar os múrmurios de um(a) #{ frase.class }" + end + frase = frase.dup + while frase.include? '(' + abre = frase.index( '(' ) + fecha = frase.index( ')', abre ) + frase[abre..fecha] = '' if fecha + end + frase + end + </pre> + + + O método @dup@ faz uma cópia de qualquer objeto. Veja a linha que adicionamos separada: + + + <pre> + frase = frase.dup + </pre> + + + Que linha de código peculiar. Como que @frase@ vira uma cópia de @frase@? + Ela se apaga? O que acontece com a @frase@ original? Ela desaparece? + + + Lembre que variáveis são como apelidos. Quando você vê @frase = "Uma (gith) espaçonave."@, + você o Ruby criando uma string e então dando um apelido a essa string. + + + Do mesmo modo, quando você vê @frase = frase.dup@, você ve o Ruby criando uma nova string e então + dando um apelido a essa string. Iso é útil dentro do seu método porque agora @frase@ é + um pelido para uma nova cópia da string que você pode usar seguramente *sem modificar a string + que foi passada pro método*. + + + Você vai ver muitos exemplos de nomes de variáveis seudo reusados. + + + <pre> + x = 5 + x = x + 1 + # x agora é igual a 6 + + y = "Endertromb" + y = y.length + # y agora é igual a 10 + + z = :include? + z = "a string".respond_to? z + # z agora é igual a true + </pre> + + + E, sim, algumas vezes objetos desaparecem. *Se você não consege pegar um objeto por uma váriavel, então + o Ruby vai entender que você já terminou com ele e vai se livrar dele.* Periodicamente, o Ruby envia seu + *garbage collector (coletor de lixo)* pra libertar estes objetos. Todo objeto é mantido na memória do + seu computador até que o coletor de lixo se livre dele. + + lang-pt/poignant-44.yml ad6c6df13017f1cc24431b8491cd78e1e69ef7a3 escobera rbocosta@gmail.com http://github.com/carlosbrando/poignant-br/commit/defd9a51d491af14e663c2c1548f668fdffb481c defd9a51d491af14e663c2c1548f668fdffb481c 2008-06-13T07:55:20-07:00 2008-06-13T07:55:20-07:00 um pedaco do 17 e do 44 516ad67b3303d8da64d5ab1a7375d3c1a68bca5c escobera rbocosta@gmail.com