diff options
Diffstat (limited to 'es-es')
-rw-r--r-- | es-es/clojure-es.html.markdown | 190 |
1 files changed, 94 insertions, 96 deletions
diff --git a/es-es/clojure-es.html.markdown b/es-es/clojure-es.html.markdown index 7102b361..1ccdc50e 100644 --- a/es-es/clojure-es.html.markdown +++ b/es-es/clojure-es.html.markdown @@ -5,39 +5,40 @@ contributors: - ["Adam Bard", "http://adambard.com/"] translators: - ["Antonio Hernández Blas", "https://twitter.com/nihilipster"] + - ["Guillermo Vayá Pérez", "http://willyfrog.es"] lang: es-es --- -Clojure es un lenguaje de la familia Lisp desarrollado para la Máquina Virtual -de Java. Tiene un énfasis más fuerte en la [programación funcional](https://es.wikipedia.org/wiki/Programación_funcional) pura -que Common Lisp, pero incluye varias facilidades de [SMT](https://es.wikipedia.org/wiki/Memoria_transacional) para manipular +Clojure es un lenguaje de la familia Lisp desarrollado sobre la Máquina Virtual +de Java. Tiene un énfasis mayor en la [programación funcional](https://es.wikipedia.org/wiki/Programación_funcional) pura +que Common Lisp, pero incluyendo la posibilidad de usar [SMT](https://es.wikipedia.org/wiki/Memoria_transacional) para manipular el estado según se presente. -Esta combinación le permite manejar el procesamiento concurrente muy simple, +Esta combinación le permite gestionar la concurrencia de manera muy sencilla y a menudo automáticamente. -(Necesitas la versión de Clojure 1.2 o nueva) +(Necesitas la versión de Clojure 1.2 o posterior) ```clojure -; Los comentatios inician con punto y coma. +; Los comentatios comienzan con punto y coma. -; Clojure es escrito en "forms" (patrones), los cuales son solo -; listas de objectos dentro de paréntesis, separados por espacios en blanco. +; Clojure se escribe mediante "forms" (patrones), los cuales son +; listas de objectos entre paréntesis, separados por espacios en blanco. -; El reader (lector) de Clojure asume que el primer objeto es una -; función o una macro a llamar, y que el resto son argumentos. +; El "reader" (lector) de Clojure asume que el primer objeto es una +; función o una macro que se va a llamar, y que el resto son argumentos. -; La primera llamada en un archivo debe ser ns, para establecer el espacio de -; nombre +; El primer form en un archivo debe ser ns, para establecer el namespace (espacio de +; nombres) (ns learnclojure) -; Más ejemplos básicos: +; Algunos ejemplos básicos: -; str creará una cadena de caracteres a partir de sus argumentos +; str crea una cadena de caracteres a partir de sus argumentos (str "Hello" " " "World") ; => "Hello World" -; Las matemáticas son sencillas +; Las operaciones matemáticas son sencillas (+ 1 1) ; => 2 (- 2 1) ; => 1 (* 1 2) ; => 2 @@ -47,44 +48,44 @@ y a menudo automáticamente. (= 1 1) ; => true (= 2 1) ; => false -; Necesitas de la negación para la lógica, también +; También es necesaria la negación para las operaciones lógicas (not true) ; => false -; Los patrones anidados funcionan como lo esperas +; Cuando se anidan Los patrones, estos funcionan de la manera esperada (+ 1 (- 3 2)) ; = 1 + (3 - 2) => 2 ; Tipos ;;;;;;;;;;;;; -; Clojure usa los tipos de objetos de Java para booleanos,cadenas de -; caracteres y números. -; Usa class para inspeccionarlos. -(class 1); Los enteros literales son java.lang.Long por default -(class 1.); Los flotantes literales son java.lang.Double -(class ""); Las cadenas de caracteres van entre comillas dobles, y son +; Clojure usa los tipos de objetos de Java para booleanos, strings (cadenas de +; caracteres) y números. +; Usa class para saber de qué tipo es. +(class 1); Los enteros son java.lang.Long por defecto +(class 1.); Los numeros en coma flotante son java.lang.Double +(class ""); Los strings van entre comillas dobles, y son ; son java.lang.String (class false); Los Booleanos son java.lang.Boolean -(class nil); El valor "null" es llamado nil +(class nil); El valor "null" se escribe nil -; Si quieres crear una lista literal de datos, precede la con una comilla +; Si quieres crear una lista de datos, precedela con una comilla ; simple para evitar su evaluación '(+ 1 2) ; => (+ 1 2) -; (abreviatura de (quote (+ 1 2)) +; (que es una abreviatura de (quote (+ 1 2)) -; Puedes evaluar una lista precedida por comilla simple con eval +; Puedes evaluar una lista precedida por comilla con eval (eval '(+ 1 2)) ; => 3 ; Colecciones & Secuencias ;;;;;;;;;;;;;;;;;;; -; Las Listas están basadas en listas enlazadas, mientras que los Vectores en -; arreglos. -; ¡Los Vectores y las Listas son clases de Java también! +; Las Listas están basadas en las listas enlazadas, mientras que los Vectores en +; arrays. +; ¡Los Vectores y las Listas también son clases de Java! (class [1 2 3]); => clojure.lang.PersistentVector (class '(1 2 3)); => clojure.lang.PersistentList -; Una lista podría ser escrita como (1 2 3), pero debemos precidirla con -; comilla simple para evitar que el lector piense que es una función. +; Una lista podría ser escrita como (1 2 3), pero debemos ponerle una +; comilla simple delante para evitar que el reader piense que es una función. ; Además, (list 1 2 3) es lo mismo que '(1 2 3) ; Las "Colecciones" son solo grupos de datos @@ -108,23 +109,23 @@ y a menudo automáticamente. (cons 4 '(1 2 3)) ; => (4 1 2 3) ; conj agregará un elemento a una colección en la forma más eficiente. -; Para listas, se agrega al inicio. Para vectores, al final. +; Para listas, se añade al inicio. Para vectores, al final. (conj [1 2 3] 4) ; => [1 2 3 4] (conj '(1 2 3) 4) ; => (4 1 2 3) ; Usa concat para concatenar listas o vectores (concat [1 2] '(3 4)) ; => (1 2 3 4) -; Usa filter, map para actuar sobre colecciones +; Usa filter y map para actuar sobre colecciones (map inc [1 2 3]) ; => (2 3 4) (filter even? [1 2 3]) ; => (2) -; Usa reduce para reducirlos +; Usa reduce para combinar sus elementos (reduce + [1 2 3 4]) ; = (+ (+ (+ 1 2) 3) 4) ; => 10 -; reduce puede tomar un argumento como valor inicial también +; reduce puede tener un argumento indicando su valor inicial. (reduce conj [] '(3 2 1)) ; = (conj (conj (conj [] 3) 2) 1) ; => [3 2 1] @@ -132,14 +133,14 @@ y a menudo automáticamente. ; Funciones ;;;;;;;;;;;;;;;;;;;;; -; Usa fn para crear nuevas funciones. Una función siempre regresa +; Usa fn para crear nuevas funciones. Una función siempre devuelve ; su última expresión (fn [] "Hello World") ; => fn -; (Necesitas encerrarlo en paréntesis para llamarlo) +; (Necesitas rodearlo con paréntesis para invocarla) ((fn [] "Hello World")) ; => "Hello World" -; Puedes crear una var (variable) usando def +; Puedes crear una var (variable) mediante def (def x 1) x ; => 1 @@ -147,32 +148,32 @@ x ; => 1 (def hello-world (fn [] "Hello World")) (hello-world) ; => "Hello World" -; Puedes acortar este proceso al usar defn +; Puedes defn como atajo para lo anterior (defn hello-world [] "Hello World") -; El [] es el vector de argumentos para la función. +; El [] es el vector de argumentos de la función. (defn hello [name] (str "Hello " name)) (hello "Steve") ; => "Hello Steve" -; Puedes usar también esta abreviatura para crear funciones: +; Otra abreviatura para crear funciones es: (def hello2 #(str "Hello " %1)) (hello2 "Fanny") ; => "Hello Fanny" -; Puedes tener funciones multi-variadic (múltiple numero variable de -; argumentos), también +; Puedes tener funciones multi-variadic: funciones con un numero variable de +; argumentos (defn hello3 ([] "Hello World") ([name] (str "Hello " name))) (hello3 "Jake") ; => "Hello Jake" (hello3) ; => "Hello World" -; Las funciones pueden colocar argumentos extras dentro de una seq por ti +; Las funciones pueden usar argumentos extras dentro de un seq utilizable en la función (defn count-args [& args] (str "You passed " (count args) " args: " args)) (count-args 1 2 3) ; => "You passed 3 args: (1 2 3)" -; Puedes mezclar argumentos regulares y dentro de una seq +; Y puedes mezclarlos con el resto de argumentos declarados de la función. (defn hello-count [name & args] (str "Hello " name ", you passed " (count args) " extra args")) (hello-count "Finn" 1 2 3) @@ -182,17 +183,17 @@ x ; => 1 ; Mapas ;;;;;;;;;; -; Mapas de Hash y mapas de Arreglos comparten una interfaz. Los mapas de Hash -; tienen búsquedas más rápidas pero no mantienen el orden de las llaves. +; Mapas de Hash y mapas de arrays comparten una misma interfaz. Los mapas de Hash +; tienen búsquedas más rápidas pero no mantienen el orden de las claves. (class {:a 1 :b 2 :c 3}) ; => clojure.lang.PersistentArrayMap (class (hash-map :a 1 :b 2 :c 3)) ; => clojure.lang.PersistentHashMap -; Los mapas de Arreglos serán convertidos en mapas de Hash en la mayoría de -; operaciones si crecen lo suficiente, así que no necesitas preocuparte. +; Los mapas de arrays se convertidos en mapas de Hash en la mayoría de +; operaciones si crecen mucho, por lo que no debes preocuparte. -; Los mapas pueden usar cualquier tipo para sus llaves, pero usualmente las -; keywords (llaves) son mejor. -; Las keywords son como cadenas de caracteres con algunas ventajas en eficiencia +; Los mapas pueden usar cualquier tipo para sus claves, pero generalmente las +; keywords (palabras clave) son lo habitual. +; Las keywords son parecidas a cadenas de caracteres con algunas ventajas de eficiencia (class :a) ; => clojure.lang.Keyword (def stringmap {"a" 1, "b" 2, "c" 3}) @@ -201,31 +202,31 @@ stringmap ; => {"a" 1, "b" 2, "c" 3} (def keymap {:a 1, :b 2, :c 3}) keymap ; => {:a 1, :c 3, :b 2} -; Por cierto, las comas son siempre tratadas como espacios en blanco y no hacen +; Por cierto, las comas son equivalentes a espacios en blanco y no hacen ; nada. -; Recupera un valor de un mapa tratando la como una función +; Recupera un valor de un mapa tratandolo como una función (stringmap "a") ; => 1 (keymap :a) ; => 1 ; ¡Las keywords pueden ser usadas para recuperar su valor del mapa, también! (:b keymap) ; => 2 -; No intentes ésto con cadenas de caracteres. +; No lo intentes con strings. ;("a" stringmap) ; => Exception: java.lang.String cannot be cast to clojure.lang.IFn -; Recuperando un valor no presente regresa nil +; Si preguntamos por una clave que no existe nos devuelve nil (stringmap "d") ; => nil -; Usa assoc para agregar nuevas llaves a los mapas de Hash +; Usa assoc para añadir nuevas claves a los mapas de Hash (def newkeymap (assoc keymap :d 4)) newkeymap ; => {:a 1, :b 2, :c 3, :d 4} -; Pero recuerda, ¡los tipos de clojure son inmutables! +; Pero recuerda, ¡los tipos de Clojure son inmutables! keymap ; => {:a 1, :b 2, :c 3} -; Usa dissoc para remover llaves +; Usa dissoc para eliminar llaves (dissoc keymap :a :b) ; => {:c 3} ; Conjuntos @@ -234,70 +235,70 @@ keymap ; => {:a 1, :b 2, :c 3} (class #{1 2 3}) ; => clojure.lang.PersistentHashSet (set [1 2 3 1 2 3 3 2 1 3 2 1]) ; => #{1 2 3} -; Agrega un miembro con conj +; Añade un elemento con conj (conj #{1 2 3} 4) ; => #{1 2 3 4} -; Remueve uno con disj +; Elimina elementos con disj (disj #{1 2 3} 1) ; => #{2 3} -; Comprueba la existencia tratando al conjunto como una función: +; Comprueba su existencia usando el conjunto como una función: (#{1 2 3} 1) ; => 1 (#{1 2 3} 4) ; => nil -; Hay más funciones en el espacio de nombre clojure.sets +; Hay más funciones en el namespace clojure.sets ; Patrones útiles ;;;;;;;;;;;;;;;;; -; Las construcciones lógicas en clojure son macros, y tienen el mismo aspecto -; que todo lo demás +; Las construcciones lógicas en clojure son macros, y presentan el mismo aspecto +; que el resto de forms. (if false "a" "b") ; => "b" (if false "a") ; => nil -; Usa let para crear una binding (asociación) temporal +; Usa let para crear un binding (asociación) temporal (let [a 1 b 2] (> a b)) ; => false -; Agrupa expresiones con do +; Agrupa expresiones mediante do (do (print "Hello") "World") ; => "World" (prints "Hello") -; Las funciones tienen un do implicito +; Las funciones tienen implicita la llamada a do (defn print-and-say-hello [name] (print "Saying hello to " name) (str "Hello " name)) (print-and-say-hello "Jeff") ;=> "Hello Jeff" (prints "Saying hello to Jeff") -; De igual forma let +; Y el let también (let [name "Urkel"] (print "Saying hello to " name) (str "Hello " name)) ; => "Hello Urkel" (prints "Saying hello to Urkel") -; Modulos +; Módulos ;;;;;;;;;;;;;;; -; Usa use para obtener todas las funciones del modulo +; Usa use para obtener todas las funciones del módulo (use 'clojure.set) -; Ahora podemos usar operaciones de conjuntos +; Ahora podemos usar más operaciones de conjuntos (intersection #{1 2 3} #{2 3 4}) ; => #{2 3} (difference #{1 2 3} #{2 3 4}) ; => #{1} ; Puedes escoger un subgrupo de funciones a importar, también (use '[clojure.set :only [intersection]]) -; Usa require para importar un modulo +; Usa require para importar un módulo (require 'clojure.string) -; Usa / para llamar funciones de un modulo -; Aquí, el modulo es clojure.string y la función es blank? +; Usa / para llamar a las funciones de un módulo +; Aquí, el módulo es clojure.string y la función es blank? (clojure.string/blank? "") ; => true ; Puedes asignarle una abreviatura a un modulo al importarlo (require '[clojure.string :as str]) (str/replace "This is a test." #"[a-o]" str/upper-case) ; => "THIs Is A tEst." -; (#"" es una expresión regular literal) +; (#"" es una expresión regular) ; Puedes usar require (y use, pero no lo hagas) desde un espacio de nombre ; usando :require, @@ -311,10 +312,10 @@ keymap ; => {:a 1, :b 2, :c 3} ; Java ;;;;;;;;;;;;;;;;; -; Java tiene una enorme y útil librería estándar, así que -; querrás aprender como llegar a ella. +; Java tiene una enorme librería estándar, por lo que resulta util +; aprender como interactuar con ella. -; Usa import para cargar un modulo de java +; Usa import para cargar un módulo de java (import java.util.Date) ; Puedes importar desde un ns también. @@ -325,7 +326,7 @@ keymap ; => {:a 1, :b 2, :c 3} ; Usa el nombre de la clase con un "." al final para crear una nueva instancia (Date.) ; <un objeto Date> -; Usa "." para llamar a métodos. O, usa el atajo ".método" +; Usa "." para llamar a métodos o usa el atajo ".método" (. (Date.) getTime) ; <un timestamp> (.getTime (Date.)) ; exactamente la misma cosa @@ -341,11 +342,11 @@ keymap ; => {:a 1, :b 2, :c 3} ; STM ;;;;;;;;;;;;;;;;; -; Software Transactional Memory es un mecanismo que clojure usa para manejar -; el estado persistente. Hay algunas cuantas construcciones en clojure que -; usan esto. +; Software Transactional Memory es un mecanismo que usa clojure para gestionar +; el estado persistente. Hay unas cuantas construcciones en clojure que +; hacen uso de este mecanismo. -; Un atom es el más simple. Dale una valor inicial +; Un atom es el más sencillo. Se le da un valor inicial (def my-atom (atom {})) ; Actualiza un atom con swap! @@ -354,11 +355,11 @@ keymap ; => {:a 1, :b 2, :c 3} (swap! my-atom assoc :a 1) ; Establece my-atom al resultado de (assoc {} :a 1) (swap! my-atom assoc :b 2) ; Establece my-atom al resultado de (assoc {:a 1} :b 2) -; Usa '@' para no referenciar al atom y obtener su valor +; Usa '@' para no referenciar al atom sino para obtener su valor my-atom ;=> Atom<#...> (Regresa el objeto Atom) @my-atom ; => {:a 1 :b 2} -; Aquí está un simple contador usando un atom +; Un sencillo contador usando un atom sería (def counter (atom 0)) (defn inc-counter [] (swap! counter inc)) @@ -371,25 +372,22 @@ my-atom ;=> Atom<#...> (Regresa el objeto Atom) @counter ; => 5 -; Otros constructores STM son refs y agents. +; Otros forms que utilizan STM son refs y agents. ; Refs: http://clojure.org/refs ; Agents: http://clojure.org/agents -``` - ### Lectura adicional -Ésto queda lejos de ser exhaustivo, pero espero que sea suficiente para -encaminarte. +Ésto queda lejos de ser exhaustivo, pero espero que sea suficiente para que puedas empezar tu camino. Clojure.org tiene muchos artículos: [http://clojure.org/](http://clojure.org/) -Clojuredocs.org tiene documentación con ejemplos para la mayoría de -funciones core: +Clojuredocs.org contiene documentación con ejemplos para la mayoría de +funciones principales (pertenecientes al core): [http://clojuredocs.org/quickref/Clojure%20Core](http://clojuredocs.org/quickref/Clojure%20Core) -4Clojure es una grandiosa forma de fortalecer tus habilidades con clojure/FP: +4Clojure es una genial forma de mejorar tus habilidades con clojure/FP: [http://www.4clojure.com/](http://www.4clojure.com/) -Clojure-doc.org (sí, de verdad) tiene un número de artículos para empezar: +Clojure-doc.org (sí, de verdad) tiene un buen número de artículos con los que iniciarse en Clojure: [http://clojure-doc.org/](http://clojure-doc.org/) |