約 3,582,710 件
https://w.atwiki.jp/hmiku/pages/36452.html
【検索用 ShinySTARS 登録タグ 2017年 CD CDS S VOCALOID 全国配信 初音ミク 初音ミクぐらふぃコレクション なぞの音楽すい星 曲 曲英 松うに 雨漏りP 雨漏りPCD】 + 目次 目次 曲紹介 音楽配信曲目 歌詞 コメント piapro 作詞：雨漏りP 作曲：雨漏りP 編曲：雨漏りP イラスト：松うに（Twitter） 唄：初音ミク 曲紹介 いつも、応援下さる皆様のお陰です。本当にありがとうございます。 曲名：『shiny★STARS』（しゃいにー★すたーず） 2017年4月3日にpiaproに投稿された雨漏りP氏のオリジナル曲。投稿時の作者ツイートはこちら 『初音ミク「マジカルミライ 2017」楽曲コンテスト』準グランプリ受賞楽曲。マジカルミライ2017にて会場BGMとして使用された。各リンクはこちら→発表動画、公式発表、作者ツイート KARENTレーベルよりダウンロード販売が行われている。初音ミク「マジカルミライ 2017」楽曲コンテスト特集配信楽曲。 2017年6月26日にニコニコ動画とYouTubeに投稿。作者ツイートはこちらニコニコ動画とYouTubeに投稿されているのはリマスター版。原曲の音源はpiaproと公式発表動画にあるので、ぜひ一度聴き比べてみてほしい。 YouTubeでは一度、5月17日に投稿されたが、松うに氏のイラストを加えてRefine版として投稿され直された際、削除されている。 + マジカルミライ2017 楽曲コンテスト 受賞楽曲一覧 マジカルミライ2017 楽曲コンテスト 受賞楽曲一覧 曲名 作曲者 ボーカル 賞 Singularity keisei 初音ミク グランプリ dear my singer 雨上がりP 初音ミク 準グランプリ shiny★STARS 雨漏りP 初音ミク 準グランプリ いるみねイト キッドP 初音ミク 準グランプリ タイニーチャーム Materia 初音ミク 準グランプリ Eternal Melodys だいすけP 初音ミク 準グランプリ 音楽配信 前作 今作 次作 - Shiny★STARS Baby Steps 流通：配信 発売：2017年8月10日 価格：￥300 レーベル：KARENT ジャケットイラスト：黒騎しゃろ iTunes Storeで購入 曲目 Shiny★STARS （feat. 初音ミク） Shiny★STARS （Instrumental） 歌詞 （PIAPROより転載） ほら失敗だらけの日は 帰り道で忘れちゃおうね 寄り道ランデブーは READY? 新しい今日になれる すれ違いばかりの日も 終わり良ければ全てよし だけど今のルートで いいのかしら アヤフヤです 選択肢はひとつだけ 簡単すぎるはず 思いをぶつけて 今日もマイペースだけど許してよね 君だけを見つめる A Lovely Girl 初めて出会うこの思いは まだ秘密なんだもん いつでもキラキラこの笑顔で 君だけに歌うよ This Lovely Song ギュッと抱いてるこの気持ちが 伝わる日まで I Sing To Shiny★STARS まだ知らない世界へジャンプ！ 笑いあえる時間がスキ だからもっと遊びたい 君と作る幸せ DAYS ドラマチックなストーリーの ヒロインにはなれないかもね だけどいまのルートも 悪くないと思えたよ 選択肢は気にしない ただ心のゆくまま 思いをぶつけて 今日もマイペースだけど許してよね 世界中一番 The Smiley Girl くだらないほど楽しい時間 宝物だね いつでもキラキラこの笑顔で 君だけに歌うよ This Lovely Song ギュッと抱いてるこの気持ちが 伝わる日まで I Sing To Shiny★STARS 今日をもマイペースだけど許してよね 君だけを見つめる A Lovely Girl 初めて出会うこの思いが 君に届くように いつでもキラキラこの笑顔で 君だけに歌うよ This Lovely Song ずっと抱いている その願いが 叶う時まで I Sing To Shiny★STARS コメント 名前 コメント
https://w.atwiki.jp/theregulation/pages/36.html
#ref error ：画像を取得できませんでした。しばらく時間を置いてから再度お試しください。 ※イメージです。 スペル：Leonard O'brien 国籍：アメリカ合衆国 年齢：40代前半 身長：191cm 体重：89kg 誕生日：unknown ASA中心メンバーの一人。 本名は[レイ・パステルナーク] 表向きは米海軍少佐だが、CIA長官でもある。 合理的な思考に、冷静で心は熱い性格の持ち主であり戦闘狂。 目的の為なら、圧倒的実力をもって制するその姿勢と国家への野心をネームレスに気に入られ、ASAへ。 Navy Sealsに独自の私兵部隊を持っている。［Seal Team Zero］ 軍人やCIAのPMO等で編成されている私兵部隊であり、それぞれの分隊に特徴がある。 装備は米軍各特殊部隊を連想させる物。豊富な実戦経験を得て洗練されたチームワークもあり、 個人の能力では勝らずとも、全体の戦闘能力及びチームワークではTRの部隊と互角に渡り合う。 レオナルド自身も戦場へ出向いて戦う事があり、右手に拳銃と左手には腰の高さほどの、独特な装飾が施された銀色の剣を手にし、近～中距離戦を得意とする。 また、驚異的な反射神経とスピードを兼ね備えており、それを活かした近接戦闘術や剣技は脅威となる。 彼の経歴は元SEALteam10の隊員であり、その後海軍の戦闘機パイロットであったこと以外は抹消されている。 外見は西洋風な顔立ちの男性、アメリカ人。 青白い髪と白い肌、セミロング。 右の青い瞳と、普段は前髪で隠している左の薄色の瞳が特徴的。 ASA技術部の試作品である左眼のオッドアイ［ハール・オージェ］、擬似ハイパーセンサーとも呼ぶべきそれは、脳への視覚信号伝達の爆発的速度向上と、極限的状況下における動体反射の強化を目的とした、肉眼へのナノマシン移植処理による物。 試作品故に使用可能時間も15分、フルで使用後は脳と肉体を疲労が襲い、数時間動けなくなるほど。 その為、護衛であるノブリスの援護が必要でありとしてツーマンセルで戦うことが多い。 彼もネームレスの独特な雰囲気を気に入っており、今までに見なかったタイプの人間と称し、ASA設立の中心メンバーとなる。 ASAの中心メンバー中でも年長者であり、おっさん臭ささから一部の若いメンバーに嫌がられる場面も。 「世界は私達が変える。なかなか演技派だろ？」 「君の行動は理解に苦しむよ…クロフォード君」 「私も君も似たようなモノだろう？、スケアクロウ」
https://w.atwiki.jp/luckyirregular/pages/16.html
適当に追加 よろしくやで(´・ω・`) 片手剣 両手剣 短剣 槍 斧 鈍器 杖 弓 カタール 鞭 ナックル 楽器 本 風魔 銃 BS武器 ケミ武器 ドゥラム武器 製薬 片手剣 武器名 素材 シミター 四葉のクローバーx1 黒い杓子x1 鉄製加工物x20 ブレイド 鉄x3 鋼鉄x3 s4ソードx1 ツルギ 環頭太刀x1 エルダーの枝x10 動く黒い物質x2 海東剣 環頭太刀x1 サイファーx20 ルーン魔法の粉x10 環頭太刀 光の粒x1 古いフライパンx1 鉄製加工物x20 レイピア 獣の皮x5 猿の爪x1 鉄製加工物x20 両手剣 武器名 素材 スレイヤー オリデオコン原石x2 古いフライパンx1 鉄製加工物x20 バスタードソード オリデオコン原石x2 セルーx10 鉄製加工物x20 ツーハンドソード バスタードソードx1 石炭x20 冷気の核x10 クレイモア 鋼鉄x3 鉄x10 赤い石x1 短剣 武器名 素材 マインゴーシュ 鉄x3 鋼鉄x3 S4ナイフx1 ダガー 光の粒x1 蟲の皮x3 鉄製加工物x20 ダーク イエローライブx2 ハチの針x3 鉄製加工物x20 カッター 鉄x1 鋼鉄x1 べとべとする液体x2 グラディウス ダガーx1 ブリガンx30 戦乙女の鎧破片x1 槍 武器名 素材 ジャベリン 鉄x1 鋼鉄x1 かたい皮x5 グレイヴ 光の粒x1 セルーx10 海涙石x1 ランス グレイヴx1 カルボーディルx20 赤い石x5 ギザルム イエローライブx2 セル―x10 海涙石x1 斧 武器名 素材 バトルアックス 鉄x3 鋼鉄x3 エメラルドx2 オーキッシュアックス 環頭太刀x1 ジルコンx20 スタージュエルのかけらx10 鈍器 武器名 素材 メイス 鉄x1 鋼鉄x1 S3クラブx1 フレイル けっこう硬い皮x5 緑の触覚x1 奇妙な部品x10 ソードメイス フレイルx1 サードオニキスx20 ルーン魔法の粉x10 スマッシャー サルのしっぽx1 黒い杓子x1 奇妙な部品x10 モーニングメイス グレイヴx1 毒キノコの胞子x30 動く黒い物質x2 杖 武器名 素材 ワンド ライトニングボルトLv3x1 猿の爪x1 ルーン魔法の粉x1 スタッフ ライトニングボルトLv3x1 ハチの針x3 冷気の核x1 アークワンド スタッフx1 サファイアx3 冷気の核x10 弓 武器名 素材 クロスボウ 硬い角x3 緑の触覚x1 海涙石x1 グレイトボウ 四つ葉のクローバーx1 けっこうかたい皮x1 海涙石x1 角弓 クロスボウx1 ジルコンx20 スタージュエルのかけらx10 アーバレスト クロスボウx1 毒キノコの胞子x30 古びた鉄塊x5 カタール 武器名 素材 ジュル 四葉のクローバーx1 緑の觸角x1 ハリネズミの大きな針x10 カタール ジュルx1 アルコールx20 古びた鉄塊x5 鞭 武器名 素材 ランテ ワイヤーx1 リボンx3 冷気の核x10 テイル ワイヤーx1 サファイアx3 戦乙女の鎧欠片x1 ワイヤー 獣の皮x5 黒い杓子x1 ハリネズミの大きな針x10 ナックル 武器名 素材 ホラ オリデオコン原石x2 硬い角x3 海涙石x1 ナックルダスター 獣の皮x5 蟲の皮x3 海涙石x1 フィスト ホラx1 アルコールx20 赤い石x5 楽器 武器名 素材 ギター リュートx1 サイファーx20 ルーン魔法の粉x10 ハープ リュートx1 ゴブリン族の仮面x5 海涙石x10 マンドリン 蝶の鱗粉x3 硬い角x3 奇妙な部品x10 本 武器名 素材 ブック 獣の皮x5 やわらかな毛x10 ルーン魔法の粉x1 バイブル ブックx1 赤いコウモリの翼x30 海涙石ｘ10 風魔 武器名 素材 十手 装飾用花x1 イエローライブx2 奇妙な部品x10 白刃 十手x1 おおネズミの爪x3 古びた塊x5 村雨 装飾用花x1 猿の爪x1 奇妙な部品x10 銃 武器名 素材 武器名 素材 BS武器 武器名 素材 クロウビークハンマー バードビークハンマーx1 クロスペインハンマーx1 スタージュエルx1 スチールビークハンマー クロウビークハンマーx1 バードビークハンマーx1 ミスリル鉱石x5 ヴァルカンハンマー スチールピークハンマーｘ１ クロウビークハンマーｘ１ 金塊ｘ１ ルミナリ―ハンマー ヴァルカンハンマーx1 スチールビークハンマーx1 金塊x2 ケミ武器 武器名 素材 イニシエートアレンビック ブラスアレンビックx1 アレンビックx1 スタージュエルx1 アイアンアレンビック イニシエートアレンビックx1 ブラスアレンビックx1 ミスリル鉱石x5 コニカルアレンビック アイアンアレンビックx1 イニシエートアレンビックx1 金塊x1 ルミナリ―アレンビック コニカルアレンビックx1 アイアンアレンビックx1 金塊x2 ドゥラム武器 武器名 素材 猫じゃらしの模型 やわらかな毛x10 セルーx10 海涙石x1 精巧な猫じゃらしの模型 猫じゃらしの模型x1 おおねずみの爪x3 戦乙女の鎧破片x1 製薬 薬品名 素材 乳鉢 石片x1 空きビン ガラス玉x1 空のポーション瓶 ガラス玉x1 空の試験管 ガラス玉x1 黄ポーション ポ―ション製造の書(所持) 黄ハーブx1 空のポーション瓶x1 乳鉢x1 青ポーション ポーション製造の書(所持) 青ハーブx1 空のポーション瓶x1 乳鉢x1 白ポーション ボーション製造の書(所持) 白ハーブx1 空のポーション瓶x1 乳鉢x1 濃縮レッドポーション 濃縮ポーションの書(所持) 赤ポーションx1 空の試験管x1 濃縮イエローポーション 濃縮ポーションの書(所持) 黄ポーションx1 空の試験管x1 濃縮ホワイトポーション 濃縮ポーションの書(所持) 白ポーションx1 空の試験管x1 フレイムハート レッドブラッドx10 ミスティックフローズン クリスタルブルーx10 ラフウィンド ウィンドオブヴェルデュールx10 グレイトネイチャ イエローライブx10 レジストファイアーポーション 属性ポーション製造の書(所持) フレイムハートx1 空のポーション瓶x1 レジストコールドポーション 属性ポーション製造の書(所持) ミスティックフローズンx1 空のポーション瓶x1 レジストウィンドポーション 属性ポーション製造の書(所持) ラフウィンドx1 空のポーション瓶x1 レジストアースポーション 属性ポーション製造の書(所持) グレイトネイチャx1 空のポーション瓶x1 星のかけら 星の粉
https://w.atwiki.jp/luckyirregular/pages/13.html
第1章
https://w.atwiki.jp/rsbuygoldq/pages/59.html
Right after abrogation the particular alcazar shift show up the particular asian additional and also to the you might have to be able to cantankerous any connection. Right after connection that shift show up arctic and also move forward touring and soon you power to any industry, abounding regarding cows. The particular a large plot would certainly current that you simply adventitious to accomplish a href="http //www.4rsgold.com/Runescape.Gold" strong Buy Runescape Gold /strong /a and also in addition to offering rare metal this kind of house can move forward the particular player s skills also. On the cow a large plot you may establish in which human beings could be getting rid of critters and also this would certainly conform that you simply adventitious to be able to aces upwards several places or perhaps bodily organs, despite having out there acquiring seen. And also just in case you can not commence virtually any in bed 1, once more wipe out 1 all on your own and acquire the disguise. An individual acknowledge to achieve this and soon you blend appropriate covers to be able to enough upwards the supply. Right after processing the supply, fall the particular covers key the particular coffer and acquire any goal coming from right now there. Following your success with this approach, indicate the particular actions previously extra regarding accession cowhides and soon you blend in a position level of covers. As a result of fact the particular extra level of covers an individual blend the particular significantly extra capacity function as plethora regarding rare metal you obtain. Concerning 100 cowhides peaceful would have been a ample success inside the journey regarding rare metal. Today, the location regarding Barrows acknowledge half a dozen mounds and also you can find half a dozen Barrow bros, loved-one s birthday of which provides their particular diverse capacity. They may be Dharok the particular Wretched, Guthan the particular Infested, Verac the particular Defiled, Torag the particular Dangerous, Karil the particular Yellow gold and also Ahrim the particular Blighted. This kind of little striking is approximately the particular bros together with certainly one of their particular crypts features a invisible tube a href="http //www.4rsgold.com/Runescape.Gold" strong Cheap Runescape Gold /strong /a . To be able to alpha dog the sport, utilize the drill down to enable you to accessibility the particular crypt. When productive, search for the particular casket and also wipe out the particular buddy which spawns and also once more shift assimilate another grave. Get the plethora torso inside the tunnels in the event you acknowledge austere the particular catacomb and also once more wipe out the particular Barrow buddy in which shields the particular torso. Loot since ample aliment that you can.
https://w.atwiki.jp/n703im/
N703iμまとめ 2007年2月20日にNECより発売されたNTTDocomo端末N703iμに関する情報のまとめサイトです。 スペック サイズ 高さ 103mm×幅 49mm×厚さ 11.4mm 質量 約 90g 連続待受時間 （静止時） 約 690時間 連続待受時間 （移動時） 約 500時間 連続通話時間 約 200分 連続テレビ電話時間 約 135分 メインディスプレイ 約 2.3インチ （ヨコ240ドット×タテ345ドット） QVGA+TM TFT液晶 262,144色 サブディスプレイ LED（7×7）赤色1色 外部メモリー microSDTMメモリーカード（別売） カメラ機能 外側：CMOSカメラ 有効画素数：約 130万 記録画素数：約 120万 内側：CMOSカメラ 有効画素数：約 33万 記録画素数：約 31万 公式サイト http //www.nttdocomo.co.jp/product/foma/703i/n703imu/ (NTT docomo) http //www.n-keitai2.com/pickup/n703myu/ (NEC) 2ch現行スレッド http //hobby9.2ch.net/test/read.cgi/keitai/1172227500/ よくある質問等(テンプレ化?) 名前：白ロムさん[sage] 投稿日：2007/03/15(木) 00 16 37 ID 0OBC00Of0 このスレ最近このAA (´・ω・｀) 多過ぎじゃね？ 見ててムカムカする。今度から使用禁止な！ #ハード周り Q.液晶から変な高周波音がします。どうにかしてください。 A.仕様なんだ。すまない。年取れば聞こえなくなるから(´・ω・｀) Q.液晶の端に色むらがあるみたい...。 A.初期出荷分はほぼすべてそうみたい(´・ω・｀)仕様？ Q.決定ボタンと↑↓ボタン押し間違いやすいんだけど。 A.薄いからしょうがないじゃん(´・ω・｀) 決定ボタンに適当なシールを貼ればそれなりに解決するよ。 Q.卓上ホルダはありますか？ A.ないよ(´・ω・｀) Q.お財布ケータイですか？ A.違いますがお財布には入りそうな薄さです(｀・ω・´) Q.ニューロポインターはありますか？ みればわかるじゃん。(´・ω・｀) Q.AFはありますか？ A.あなるふぁっく？ねーよ？(´・ω・｀) #ソフト周り Q.メッセージR,Fをメール問い合わせで確認したくない。 A.SETTINGS→アプリケーション通信設定→iモード問い合わせ設定 Qメール返信時に元メールを参照することはできますか？ Aメールの返信本文入力画面→機能→受信メール参照 Qマルチタスクはありますか？ A従来よりかなり簡素化されてます(´・ω・｀) 最初に iアプリ か iモード を立ち上げた場合 のみ、終了時にPWRボタンを押すと『中断』が選択でき、他の作業を終えて戻ると、中断前の状態から続けることが出来る。 以下具体的な例（丸囲み数字は機能を立ち上げた順） ①iモード ②iアプリ →できる。この場合のみ待受に戻らず交互に行き来できる。 ①iアプリ ②メール →できる。 ①アプリ ②マイピクチャを表示して画像編集 →できる。 ①メール ②iアプリ →できない。 メールを閲覧している画面からアプリを動かすには一端メールタスクを終了。 ①マイピクチャ ②iモーション →できない。（従来のマルチタスク対応機種でも同様） ①iアプリ中 ②バックライト輝度調節 →できる。 アプリを中断し、バックライトを調節して、アプリの中断したところに戻れる。 ①iアプリ中 ②iアプリ音量調整 ③マナーオンオフ →できる。 アプリを中断し、音量調整やマナーオンオフをして、アプリの中断したところに戻れる。 ①ミュージックプレイヤー ②iモード ③受信メールに返信 →ミュージックプレーヤーで着うたを再生しBGM設定、さらにiモードをしつつ、 メールは iモードセンターから受信する までなら可能。 メールを見る には、iモードを終了させなくては無理。 iモードを終了させれば、メールを見て返信し、ミュージックプレーヤに戻れる。 ①ミュージックプレイヤー ②カメラ できない。 “ミュージック起動中です操作できません”と表示される。 #その他 Q.CMで使われている曲は？ Dragon Ash - El Alma Q.関西地区では人気があるようですが。 A.これに似てるからです。 特集記事関連
https://w.atwiki.jp/93727/pages/140.html
概要 曲一覧 メンバー おすすめ動画 アルバム曲目リスト 概要 下記の人物はシーズン9のアトランタ予選に登場した、63歳のラリー・プラットである。この時点で年齢が応募資格によりオーディションに適していないが一応審査をしたという。 彼はオーディションに Pants On The Ground （パンツがずり落ちた）というラップ調のオリジナル曲を持ち込んだ。 曲一覧 メンバー パトリック・スタンプ (Patrick Stump) 1984年4月27日 - ギター、ボーカリスト、作曲家、ピアニスト。 はじめはドラムとしてバンドに加わったが、メンバーの中にボーカルに 相応しい人物がいなかった為代わりにパトリックがボーカルを担当 することになった。その後、バンドのためにギターも演奏し始めた。 彼以外のメンバーは全員タトゥーを入れている。 ピート・ウェンツ (Pete Wentz) 1979年6月5日 - ベーシスト、作詞家。 New Trier High高校とNorth Shore Country Day学校に通い、 州代表のサッカープレイヤーだった。 2008年4月に歌手のアシュリー・シンプソンとの婚約を発表、 5月17日に結婚し、2008年11月20日に男児が誕生。ベジタリアンである。 ジョー・トローマン (Joe Trohman) ギター アンディ・ハーレー (Andy Hurley) ドラムス ↓Fall Out Boy ↓左端がJoe Trohman、ギターを担いでいるのがPete Wentz、 ギターを持ち上げているのがPatrick Stump、ドラムスティックを 鉄砲のように持っているのがAndy Hurleyである。 ↓アニメ｢ザ・シンプソンズ」に登場するマンガのキャラクターで バンド名のモデルになった"Fallout Boy"。 imageプラグインエラー ご指定のURLはサポートしていません。png, jpg, gif などの画像URLを指定してください。 おすすめ動画 おすすめ動画へ⇒ アルバム 曲目リスト imageプラグインエラー ご指定のURLはサポートしていません。png, jpg, gif などの画像URLを指定してください。 Believers Never Die Greatest Hits (W/Dvd) Disc 1 1. Dead On Arrival 2. Grand Theft Autumn (Where Is Your Boy) 3. Saturday 4. Sugar, We re Goin Down 5. Dance, Dance 6. A Little Less Sixteen Candles, A Little More Touch Me 7. This Ain t a Scene, It s an Arms Race 8. Thnks fr th Mmrs 9. Take Over, The Breaks Over 10. I m Like A Lawyer With The Way I m Always Trying To Get You Off (Me You) 11. Beat It 12. I Don t Care 13. America s Suitehearts 14. What A Catch, Donnie 15. Alpha Dog 16. From Now On We Are Enemies 17. Yule Shoot Your Eyes Out 18. Growing Up Disc 2 1.Dead On Arrival ミュージックビデオ 2.Grand Theft Autumn (Where Is Your Boy) ミュージックビデオ 3.Saturday ミュージックビデオ 4.Sugar, We re Goin Down ミュージックビデオ 5.Dance, Dance ミュージックビデオ 6.A Little Less Sixteen Candles, A Little More "Touch Me" ミュージックビデオ 7.This Ain t a Scene, It s an Arms Race ミュージックビデオ 8.Thnks fr th Mmrs ミュージックビデオ 9.Take Over, The Breaks Over ミュージックビデオ 10.I m Like A Lawyer With The Way I m Always Trying To Get You Off (Me You) ミュージックビデオ 11.Beat It ミュージックビデオ 12.I Don t Care ミュージックビデオ 13.America s Suitehearts ミュージックビデオ 14.What A Catch, Donnie ミュージックビデオ 15.The Carpal Tunnel Of Love ミュージックビデオ（日本版のみ収録） FOLIE A DEUX 1. Disloyal Order Of Water Buffaloes 2. I Don t Care 3. She s My Winona 4. America s Suitehearts 5. Headfirst Slide Into Cooperstown On A Bad Bet 6. The (Shipped) Gold Standard 7. (Coffee s For Closers) 8. What A Catch, Donnie 9. 27 10. Tiffany Blews 11. w.a.m.s. 12. 20 Dollar Nose Bleed 13. West Coast Smoker 14. Beat It 15.Lullabye Infinity on High (Spec) (Dlx) (Dig) 1. Thriller 2. Take Over, The Breaks Over 3. This Ain t a Scene, It s an Arms Race 4. I m Like A Lawyer With The Way I m Always Trying To Get You Off (Me You) 5. Hum Hallelujah 6. Golden 7. Thnks fr th Mmrs 8. 9. (After) Life of the Party 10. Carpal Tunnel of Love 11. Bang the Doldrums 12. Fame Infamy 13. You re Crashing, But You re No Wave 14. I ve Got All This Ringing in My Ears and None on My Fingers From Under the Cork Tree 1. Our Lawyer Made Us Change The Name Of This Song So We Wouldn t Get Sued 2. Of All The Gin Joints In All The World 3. Dance, Dance 4. Sugar, We re Goin Down 5. Nobody Puts Baby In The Corner 6. I ve Got A Dark Alley And A Bad Idea That Says You Should Shut Your Mouth (Summer Song) 7. 7 Minutes In Heaven (Atavan Halen) 8. Sophmore Slump Or Comeback Of The Year 9. Champagne For My Real Friends, Real Pain For My Sham Friends 10. I Slept With Someone In Fall Out Boy And All I Got Was This Stupid Song Written About Me 11. A Little Less Sixteen Candles, A Little More Touch Me 12. Get Busy Living Or Get Busy Dying (Do Your Part To Save The Scene And Stop Going To Shows) 13. XO 14.The Music Or The Misery My Heart Will Always Be B-Side to My Tongue 1. Nobody Puts Baby In The Corner 2. My Heart Is The Worst Kind Of Weapon 3. It s Not A Side Effect Of The Cocaine. I Am Thinking It Must Be Love 4. Love Will Tear Us Apart 5. Grand Theft Autumn (Where Is Your Boy) Take This To Your Grave 1. Tell That Mick He Just Made My List of Things to do Today 2. Dead On Arrival 3. Grand Theft Autumn (Where Is Your Boy) 4. Saturday 5. Homesick at Space Camp 6. Sending Postcards from a Plane Crash (Wish You Were Here) 7. Chicago is so Two Years Ago 8. The Pros and Cons of Breathing 9. Grenade Jumper 10.Calm Before the Storm 11. Reinventing the Wheel to Run Myself Over 12. The Patron Saint of Liars and Fakes Fall Out Boy s Evening Out with Your Girl 1. Honorable Mention 2. Calm Before the Storm 3. Switchblades and Infidelity 4. Pretty in Punk 5. Growing Up 6. World s Not Waiting (For Five Tired Boys in a Broken Van) 7. Short, Fast, and Loud 8. Moving Pictures 9. Parker Lewis Can t Lose (But I m Gonna Give It My Best Shot) 上へ
https://w.atwiki.jp/irissetlist/pages/186.html
【昼公演】i☆Ris 結成5周年記念Live～5 years old! Everyone comes together☆～ 2017年7月17日(月･祝) かつしかシンフォニーヒルズモーツァルトホール 01 §Rainbow 02 鉄腕ガール 03 徒太陽 04 真夏の花火と秘密基地 05 Vampire Lady 06 ドリームパレード 07 Goin'on En Color
https://w.atwiki.jp/leathermanunofficial/pages/46.html
Camouflage Edition 公式サイトに垣間見られるCamoモデルに関する覚え書き。 [Leatherman USA] CAMO FUSE CAMO BLAST 13 16 4 in / 10 cm 4 in / 10 cm 6 oz / 170 g 6.9 oz / 196 g 3.0 in / 7.62 cm 3.0 in / 7.62 cm #ref error ：ご指定のファイルが見つかりません。ファイル名を確認して、再度指定してください。 (=http //cdn41.atwikiimg.com/leathermanunofficial/?cmd=upload act=open pageid=46 file=BlastCamo.jpg) Needlenose Pliers Needlenose Pliers Regular Pliers Regular Pliers Wire Cutters Wire Cutters Hard-wire Cutters Hard-wire Cutters 420HC Knife 420HC Blade Saw Spring-action Scissors Spring-action Scissors Wood/Metal File Small Bit Driver Phillips Screwdriver Phillips Screwdriver Large Screwdriver Large Screwdriver Small Screwdriver Small Screwdriver Ruler (8 in / 19 cm) Ruler (8 in / 19 cm) Bottle Opener Bottle Opener Can Opener Can Opener Wire Stripper Wire Stripper [leathermanlibrary.com] サムネイル ファイル名 サイズ 公式サイト ミラー Charge XTi Camo Camo_XTI_O_copy.png 2.16 MB leathermanlibrary.com i.imgur Charge TTi Camo TTi_Camo_Fanned_copy.png 1.45 MB leathermanlibrary.com i.imgur SURGE_Gander_MT SURGE_Gander_MT_copy.png 1.75 MB leathermanlibrary.com i.imgur OHT Camo OHT_CAMO_OPEN_large.jpg 1.20 MB leathermanlibrary.com i.imgur
https://w.atwiki.jp/katzchang/pages/12.html
このページはhttp //ioke.org/wiki/index.php/Guideからの引用です Guide Introduction はじめに Ioke is a general purpose language. It is a strongly typed, extremely dynamic, prototype object oriented language. It ishomoiconicand its closest ancestors areIo,Smalltalk,RubyandLisp- but it s quite a distance from all of them. It looks a lot like Io, to a limit. Iokeは汎用言語です。極動的な強い型付け、プロトタイプベースのオブジェクト指向言語です。homoiconic(http //en.wikipedia.org/wiki/Homoiconicity)であり、Io、Smalltalk、Ruby、Lispに近い系統の言語です。が、それらとは大きな違いもあります。見た目はほとんどIoです。to a limit? Ioke is afoldinglanguage. This means it folds in on itself. You can create new abstractions covering any of the existing abstractions in the language. You can abstract over these, over and over again, until you have a language that lets you express what you want to express in a succinct and readable way. Ioke allows you to fold your code. Iokeは織り込み(いい言葉はない?)言語です。自分自身に織り込むということです。言語が用意する既存の抽象階層を拡張する新たな抽象階層を、自由に作成できます。その抽象階層をさらに拡張することも可能で、必要に応じた簡潔で読みやすい言語を作ることもできます。Iokeにあなたのコードを織り込むことができます。 Ioke is targeted at the Java Virtual Machine and is tightly integrated with the platform. Why the JVM? It s available everywhere, it gives several important features such as world class garbage collectors, capable thread schedulers and an amazing JIT compiler. All of these are things that serve Ioke well, without requiring direct development resources from the Ioke team. Access to the Java platform also means access to all existing libraries and functionality, with all that entails. The JVM is just a very pragmatic choice. IokeはJVM(Java Virtual Machine)をターゲットとして、JVMプラットホーム上で開発されています。なぜJVMか？どこでも実行可能で、ガベージコレクタや優秀なスレッドスケジューラ、素晴らしいJITコンパイラなどの重要な機能をサポートしているからです。それらの機能はすべてIokeにも必要な機能を、Ioke開発チームが直接作る必要がありません。Javaプラットホームへのアクセスできるということは、必然的に、既存のライブラリや機能性へアクセスできるということになります。JVMは実に実用的な選択です。 You re probably reading this guide atioke.org. That is the official home of the project, although some of the project functionality is hosted atKenai, where such things as mailing lists and a bug tracker is available. The canonical source repository for Ioke is onGitHub. 今あなたは、ioke.orgにあるガイドを読んでいると思います。ioke.orgはこのプロジェクトの公式サイトです。また、メーリングリストやバグ管理などのプロジェクト機能の一部はKenaiにあります。Iokeの正式なソースレポジトリはGitHubにあります。 The current version of Ioke is calledIoke E. The naming of Ioke will change regularly with major revisions. There are two different versions in play here.Ioke Eis the name and version of the language and core libraries. The initial implementation forIoke Eis calledikj 0.3.0, and the version numbers are not interdependent. The next major version of Ioke will be calledIoke P, and you can find information about it in the chapter onfuture plans. Iokeの現行バージョンはIoke Eです。Iokeの名前はメジャーバージョンで変わるよう付けています。2つのバージョンがあり、Ioke Eは言語仕様とコアライブラリのバージョンを指しています。Ioke Eの最初の実装はikj 0.3.0で、バージョン番号は相互依存ではありません。次のメジャーバージョンはIoke Pで、情報はfuture plansの章にあります。 This programming guide -- together with the reference for your current version -- should be the complete document needed to understandIoke E, how to program in it, how to understand the names and concepts used, and also give an initial inkling on what I think is good taste. このプログラミングガイドは（あなたのカレントバージョンのリファレンスもそうですが）、Ioke Eを理解するためのドキュメントであり、どのようにプログラムを作成するかとか、どのように用語やコンセプトを理解するかとか、私がいいと思うような初期のほのめかしも書かれています。 Note that I will use many names that aren t necessarily the same as the ones traditional programming languages use. These names will be made clear sooner or later in this document, but it might help some to jump forward toObjects, skim that bit, and then start over once words lik eOrigin,cellandmimicmake sense. ここで使う用語は、既存のプログラム言語で使われる用語と意味が同じとは限りません。用語についてはドキュメント内で時機に明確になりますが、Objects章、とくにOrigin、cell、mimicについて、さらっと読んでおいてもいいかも知れません。 Vision 構想 The evolution of programming languages is a steady progression of finding new ways to express abstractions naturally - in a way that doesn t stray too far away from the smaller details. A programming language has to make it possible to abstract away common things, while making it easy to customize these abstractions in very detailed ways. A programming language should be able to do this well without sacrificing readability and understandability. This tension lies at the core of programming. プログラミング言語の進化は、抽象階層を自然に記述する新しい方法を見つけるための着実な前進です。より詳細な点からそんなに遠く外れることはなく?。プログラミング言語は共通事項の抽象化を可能にし、細部に渡る抽象階層を簡単にカスタマイズ可能にしました。プログラミング言語に読みやすさや理解しやすさも必要です。この葛藤こそが、プログラミングの本質です。 How do you create a language that makes it easy to express powerful concepts in a succinct way, while still making it easy to maintain and work with after the fact, without turning it into a new compression mode? How do you make it easy for a programmer to express high level abstractions that are abstractions of abstractions of abstractions? では、言語をどのように作れば、簡潔な方法でパワフルかつ簡単に概念を記述できるようになるのでしょうか？同時に、事後の保守を簡単に出来るようにするには？新しい圧縮モード(?)を不要とするには？言語をどのように作れば、プログラマが抽象階層の抽象階層の抽象階層といった、高レベルの抽象階層を簡単に書くことができるのでしょうか？ There are many open problems in programming language design. Concurrency is one of them, performance another. These are two areas Ioke does not address. Instead, Ioke is a remodeling of the core concepts and ideas embodied in other programming languages. プログラミング言語設計には、多くの未解決問題があります。一つは並列処理で、もう一つはパフォーマンスです。これら2つの問題領域には、Iokeは踏み込んでいません。その代わりに、Iokeはコア構造の再構築を可能にし、他のプログラミング言語のアイデアを盛り込めるようにしています。 Are Lisp and Smalltalk still the most powerful languages around, or are there ways of providing more expressiveness without sacrificing understandability? Is there a way to combine all the lessons learned from languages like Ruby and Python, and patch them back into a Lisp and Smalltalk core? Is it possible to do this while taking some of the benefits of Io? Can a language be both small, regular, homoiconic, reflective and easy to understand? I hope that Ioke is just that. Simplicity doesn t mean lack of power. Small, simple, orthogonal functionality can be more powerful than larger, complicated abstractions that don t fit together. Io explicitly states that the goal of the language is to refocus attention on expressiveness, and with Ioke I want to take that philosophy one step further. It s important to realize that an experiment like this doesn t necessarily have to mean the language can t be used for real projects. By wedding Ioke to the Java Virtual Machine, I make it easy to get access to good libraries and existing implementations on most platforms. In that way, Ioke can be used to create real systems, even though the ecosystem will initially be very small. And I think that this is necessary. How can you know if a language really is worthwhile or not, if you can t use it as a general purpose programming language? The Java platform makes this possible. Getting started はじめよう Ioke is very easy to get started with. The first step is to download a package. Which one you choose depends on what platform you re on, and whether you want to build Ioke yourself, or just start using it. This guide will only cover using a prebuilt version. Go to thedownload page, and grab one of the distributions. At the time of writing the full version of Ioke is Ioke E ikj 0.3.0. Choose the latest download in the 0.3-series for this document to apply. Once you have downloaded the distribution, you need to unpack it somewhere, and finally add thebindirectory to yourPATHenvironment variable. There is also ajardownload that can be run directly. If you choose this option you don t get the benefits of having a home for Ioke, which in some cases might be inconvenient. Ioke can be run directly from the jar file, though. Building Ioke Iokeのビルド If you d like to build Ioke from source, make sure you have a recent version of theJava Development Kitinstalled (1.5.0 or higher, preferrably 1.6.0) andApache Ant. You must have theantscript reachable from yourPATHvariable. Then, simply check out the source code from themain repository, and build it usingant. That should run all the compilation steps and tests, and allow thebin/iokescript to run. Just proceed as if you had unpacked the distribution, adding thebindirectory to thePATH. Running scripts スクリプトを実行 To run an Ioke script, you can generally just use theiokecommand $ ioke helloWorld.ik Hello world You can also execute snippets of code on the command line using the-eargument to theiokecommand. You can have several of these in the same line too $ ioke -e Hello world println -e Goodbye world println Hello world Goodbye world When using-e, be careful about what quoting style you use, since the shell sometimes can munge up your commands if you don t surround them correctly. Theiokecommand has several helpful command line options, which can change what happens during execution. These are -Cdirectory Switch to directory before executing any files and command line scripts. This will make the directory the initial current working directory for Ioke during the execution of the JVM. -d Enable debug output. -e script Execute script, as describe above. May occur more than once on a command line. -h --help Display help information, including descriptions of these command line options. -Idirectory Add directory to the load path of Ioke. May occur more than once on a command line. -JjvmOptions Pass on options to the JVM. This can be used to change any runtime parameters that your JVM takes. May occur more than once. The options are provided directly after the -J, so if you want to change the maximum amount of memory used, you can do that writing -J-Xmx128M. --copyright Print copyright information and exit. --version Print version information and exit --server Run the JVM in server Hotspot mode --client Run the JVM in client Hotspot mode (the default) -- Mark the end of options to theiokescript, anything after this are options to be sent to the code running. If you provide the name of a script file on the command line, it should come after all the arguments to theiokescript. Everything after the script will be added as data to theSystem programArgumentscell. You can use both one-line scripts with-eand specify a script file. If so, the script file will be run after the one-line scripts. Interactive mode インタラクティブモード If no code to execute has been specified to theiokescript,IIk - Interactive Ioke- will start. This is a REPL that allows the execution of arbitrary code in a shell that immediately displays the result. The main difference between running Ioke from a file and interactively is that the interactive prompt will show a notice of the result of the last operation after each execution. IIk will also invoke a debugger when aconditionis encountered. This debugger gives you the possibility to inspect what happened more closely. The final difference with IIk is that it does not execute code directly in Ground - which the top level inside an Ioke script will do. This difference is crucial, when considering namespacing issues. IIk will try to use Readline through JLine if your platform supports it. IIk will be more closely described later, but just to give you a glimpse, this is how a small session could look like iik hello world println hello world + nil iik 10 * 20 + 200 iik 3/2 + 3/2 iik 3/2 + 3/2 + 3 iik 3/2 * 3 + 9/2 iik foo = hello + hello iik foo + hello iik exit Bye. When you see the prompt iik , you know that IIk is waiting for input. The result of a computation is shown after the + sigil. You can exit from IIk by calling either exit or quit . There is also a restart named quit that can be invoked to quit IIk. Syntax 構文 Ioke has no keywords or statements. Everything is an expression composed of a chain of messages. A piece of code is represented as a chain of messages that links to the next message. The result of one message will be the receiver of the next message, until a . message is received. The . message is a terminator that throws away the current receiver. A newline will serve as a . message in the circumstances where it feels natural. An informal BNF description of Ioke looks like this program = messageChain? messageChain = expression+ expression = message | brackets | literal | terminator literal = Text | Regexp | Number | Decimal | Unit message = Identifier ( ( commated? ) )? commated = messageChain ( , messageChain )* brackets = ( [ commated? ] ) | ( { commated? } ) terminator = . | \n comment = ; .* \n What isn t visible here is that all whitespace -- except for newlines -- will work only as separators of messages, and is otherwise ignored. That means that message sending does not use the dot, as in most other languages. A phrase such asfoo().bar(quux(42)).baaz()would be expressed asfoo() bar(quux(42)) baaz(), or more succinctlyfoo bar(quux(42)) baazin Ioke. All the types of literals are actually turned into a message to create that literal, so the canonical form of the message chain contains no literals, just a message to create that literal. Any message can have zero or more arguments given to it. Arguments are separated with comma. If there are no arguments to a message, the parenthesis can be left off, but they need to be there if there are arguments. Mostly any combination of characters can be used as an Identifier, with some exceptions. There used to be a parsing element called operators, but these have now been included into identifiers. They are not parsed differently at all, but the operator shuffling step will handle them differently. Specifically, operators can be used in infix, including having different precedence rules. Assignment is a specific form of operator which gets its own kind of shuffling. These are both described below. An identifier in Ioke can be one of several things. Ioke takes the rules for Java identifiers, and adds some more to them. All Unicode letters and digits can be part of an identifier, except for the first entry. Underscores are allowed, just like in Java. Ioke also allows colons as an identifier. Exclamation mark and question mark is allowed anywhere in the identifier except for in the beginning. Identifiers can be broadly classified into identifiers and operators, where operators can be any combination of several sigils. There are also some special operators that have restrictions. These are Opening and close brackets are not allowed, except together with its counterpart, so [ is not a valid identifier, while [] is. So is {}. () is not valid either. Two or more dots is a valid identifier. A hash sign can be followed by any operator char, but isn t parsed as an identifier by itself. Slash is not an operator char, but can be used as it except in combinations that look like regular expressions. The operator chars are +, -, *, %, , , !, ?, ~, , |, ^, $, =, @, , ` and . These can be combined together in any order, and any number, except for the caveats noted before. That means the available operator space is infinite, and very wide. Combinations of letters and operator characters are generally not allowed, except for the exceptions with , ! and ?. This is to make it possible to have infix operations without spaces in some situations. The two forms of brackets will get turned into a canonical form. Surrounding comma-separated message chains with square brackets is the same as calling the method [], giving it those message chains as argument. So [foo, bar, quux] is exactly the same as [](foo, bar, quux). The same is true for curly brackets. Comments start with semicolon and end at the first newline. They can be used mostly anywhere, except inside of literal texts. The hash sign followed by an exclamation mark is also a comment, to allow the shebang line in Unix scripts. How and when the actual evaluation of messages happen depend on what kind the message type is. If it s inactive, the value reflecting that cell will be returned. If it s active, the cell will be activated and the result of that activation returned. How the activation depends on what kind of code the cell contains. The various kinds of code is described more closely in the chapter aboutcode. Literal values リテラル値 Ioke currently contains four different kinds of literals. There is a fifth quasi literal, that isn t exactly parsed as a literal, but will be evaluated differently based on its name. These literals are texts, regular expressions, integers and decimal numbers. Symbols are actually parsed as regular identifiers, but they are handled a bit differently during evaluation. Text テキスト A literal text in Ioke is what is generally called strings in most languages. As in most languages, text is written inside of double quotes. Any characters are valid inside of those double quotes. That includes newlines - so you can write a literal text that extends to several lines. There is an alternate syntax for text when the value contains a lot of double quotes. As in most other languages, several escapes are valid inside of a text. Escapes are preceded by the backslash, and insert the character corresponding to the escape values. These escapes are \b Inserts the backspace character, that is represented in ASCII by the decimal value 8. \e Inserts the character that is represented in ASCII by the decimal value 27. This value is used for sending escape values to the TTYs in some operating systems. \t Inserts the TAB character - ASCII decimal 9. \n Inserts the newline character - ASCII decimal 10. \f Inserts the form feed character - ASCII decimal 12. \r Inserts the carriage return character - ASCII decimal 13. \ Inserts the double quote character - ASCII decimal 34. \\ Inserts the backslash character - ASCII decimal 92. \[newline] Inserts nothing at all. Used to escape necessary newlines, without having them show up in the output text. \# Inserts a literal hash character - ASCII decimal 35. \uABCD Inserts the Unicode codepoint corresponding to the hexadecimal value of the four characters following the u . All four hexadecimal characters need to be specified. \7, \12, \316 Inserts the Unicode codepoint corresponding to the octal value of the one, two or three octal characters. The maximum value allowed is \377, and the minimum is obviously \0. Ioke also supports an alternative text syntax that can be used when the text in question contains many scare quotes. The alternative syntax starts with #[ and ends with ]. A right bracket will have to be escaped, but scare quotes doesn t have to be. The parsing of text will generate a message with name internal createText . This message will get one argument that is the raw Java String corresponding to the text. Ioke allows automatic interpolation of arbitrary values in the same manner as Ruby. It uses the same syntax for this, which is the #{} syntax inside a text. These can be nested in any way. The elements will be parsed and sent as arguments to the message with name internal concatenateText . So an Ioke text such as foo bar#{flux} will #{1+2} will generate the message internal concatenateText( foo bar , flux, will , 1+(2), ). As you can see, there is a small amount of waste in the way this is generated -- but the simple model makes it easy to understand. It s not guaranteed that this will remain the same, although the message will definitely remain. Some examples foo flax\mux one two #{three}\bfour #[you don t really #{1+2+3} believe that?] Regular expressions 正規表現 Ioke has very capable regular expressions. Exactly what you can do with them can be found further down in this guide. The literal syntax allows regular expressions to be embedded in code directly. The syntax for this starts with a #/ and ends with another /. The last slash can optionally be followed by some flags that change the behavior of the expression. Regular expressions can also use an alternative syntax that starts with #r[ and ends with ]. Just as with Text, regular expressions can contain interpolation. This interpolation will be transformed into regular expressions and then combined with the outer regular expression. A few examples might be in order here #//#r[]#/foo/#r[foo]#/fo+/x#r[fo+]x#/bla#{ foo }bar/#r[bla#{ foo }bar] The first example is an empty regular expression. The second is an expression matching the word foo . The third expression matches an f followed with one or more o . It also allows extended regular expression syntax, due to the x flag. The flags supported in Ioke are x, i, u, m and s. The meaning of these match the meaning of corresponding Ruby flags. Regular expressions allow most of the same escapes as Ioke text. Specifically, these escapes are supported b, t, n, f, r, /, \ and newline. Unicode and octal escapes also work. The fourth example shows the insertion of a literal text inside of a regular expression. Ioke regular expressions will be transformed into a call to internal createRegexp. This message expects two Java strings, one with the actual pattern, and one with the flags. Integers 整数値 Ioke supports arbitrarily sized numbers. It also contains a numerical tower that can be more closely explored in the reference documentation. The numerical tower is based in Number. Number Real mimics Number. Number Rational mimics Number Real, and so does Number Decimal. Finally, Number Integer and Number Ratio both mimics Number Rational. The interesting parts of this tower is Number Integer, which corresponds to integers, Number Ratio, which is any ratio between two integers, and Number Decimal, which corresponds to decimal numbers. These are arbitrarily sized and exact. There are no floats or doubles in Ioke. There is also a potential place for Number Complex at the same layer as Number Real, although complex numbers are not currently implemented. There are also plans for implementing a unit system further down the line. Literal integers can be written using either decimal or hexadecimal notation. Hexadecimal notation begins with 0x or 0X and are then followed by one or more hexadecimal letters. They can be either upper or lower case. A decimal literal number is written using one or more decimal letters, but nothing else. There is no literal to create ratios - these can only be created by division of integers. Negative numbers have no literal syntax, but preceding a number with a minus sign will call the message - on the number and generate the negative value. A literal integer will be transformed into a call to internal createNumber, which takes one native Java String from which to create the number. Some examples 123444444444444444444444444444444444444423523453453400xFFFFF Decimals 数値 Literal decimal values can be written either using exponential notation, or using a decimal dot. A decimal dot notation can be combined with exponential notation. Exponential notation starts with a number or a decimal number, followed by lower or upper case E, followed by an optional sign, and then followed by one or more decimal letters. A literal decimal will be transformed into a call to internal createDecimal, which takes one native Java String from which to create the decimal. Some examples 0.01E61E-3223.4445e10 Symbols シンボル Symbols aren t exactly syntax, but they aren t exactly messages either. Or rather, they are messages that will evaluate to the symbol that represent themselves. Symbol is a kind in Ioke. There are two kinds of symbols - the first one is simple symbols that can be parsed as is. The second is symbols that can t be parsed as is. Symbols are preceded by a colon and then directly followed by the symbol text. If it can t be parsed correctly, the value should be surrounded by quotes, and this will be turned into a call to the method , which takes the text as argument. That means that you can actually get dynamic symbols by calling the method. Some examples foo flaxBarFoo mux mex mox\n Operator shuffling 演算子のようなもの One exception to the way message handling works in Ioke is operators. All the so called operators in this section is possible to call directly in message passing position too -- but to make it possible to use them in a more natural way, the parsing step will handle them a bit differently, and then do a shuffling step that actually takes operator precedence into account. So all the common operators will generally work as you expect them to -- although I recommend adding parenthesis when something is possibly unclear. Ioke has a slightly larger amount of operators than most other languages. Most of these are currently unused, but they are certainly available for use for any purpose the programmer wants to use it for. Many adherents of other languages (Java, I m looking at you) claim that operator overloading is evil. I don t believe that is true, seeing as how it works so well in Ruby, so Ioke instead allow you quite large freedom with regards to operators. The precedence rules for regular operators can be found in the cell Message OperatorTable operators , which is a regular Dict that can be updated with new values. The new values will obviously not take effect until the current code has run, and a new parse is started. Note that the below is only the operators that have defined precedence rules. As noted in the section on syntax, you can use any operator you want really. It is easy to add new precedences to the table, either temporarily or permanently. At the time of writing, the available operators - in order of precedence - are these ! ? $ ~ # ** * / % + - = = = == != === =~ !~ ^ | ? || ?| .. ... = - - + ! % # @ / * ? | ^ ~ - + ! % # @ / * ? | ^ ~ = ** ** || || $ $ += -= **= *= /= %= and nand = = ^= or xor nor |= ||= = = - return And as mentioned above, all of these can be used for your own purpose, although some of them already have reserved meanings. This document will cover most of the used operators, while the rest can be found in the reference. Since this operator shuffling happens, that also means that an Ioke program has a canonical inner form that can differ from the source text. When you use introspection of any kind, you will get back that canonical form which might not look exactly like you expected. Similarly, if you ask some code to print itself, it will use the canonical form instead of the operator skin. Macros that modify message chains should work against the canonical form, and nothing else. What an operator does depends on the result of sending the message of that name to the receiver, just like regular messages. In fact, to Ioke there really isn t any difference, except that the parsing takes special notice about operators and assignment operators. Assignment shuffling 代入のようなもの Much like with regular operators, trinary - assignment - operators are subject to a kind of shuffling. This shuffling differs from regular operator shuffling, in that it will shuffle around two things - the left hand side and the right hand side. This is true for every assignment operator except for the unary ones, which will only reshuffle one message. A few examples might make the translation easier to perceive. The first item is the readable form, while the second form is the canonical form foo=1+2=(foo,1+(2))Groundfoo*= text Ground*=(foo, text )bar foo(123)=42bar=(foo(123),42)flux++++(flux) These examples show some more advanced details -- specifically the fact that assignment operators generally work on places , not on names or cells. This will be more explored in the chapter onassignment. The important thing to notice from the above examples is that for most assignments two things will be rearranged. For the unary operators only one thing will be moved. Just as with regular operators, the assignment operators have information in the Message OperatorTable cell. The specific cell is Message OperatorTable trinaryOperators , and it matches an assignment operator to either the integer 1, or the integer 2. Everything with 1 will be matched as being unary assignment. The currently available assignment operators are = ++ -- += -= /= **= *= %= = = |= ||= ^= = = Just as with regular operators, what an assignment operator does depend on what the result is from sending the message of that name to the receiver object, just like with any type of message. Inverted operators 否定演算子 In addition to the regular binary operators and the trinary assignment operators, Ioke also sports inverted operators. These aren t actually used anywhere in the core distribution, but they might be useful at some time or another. The basic idea is that sometimes you want to have the right hand side of an expresssion become the receiver of an operator call, and the left hand side become the argument to the operator. Inverted operators allow this. As with both the binary and trinary operators, you can find and update information about inverted operators in the cell Message OperatorTable invertedOperators . To make this a little less abstract, let us look at two simple examples and what they translate into foo [1,2,3,4]map(asText);; will be translated to[1,2,3,4]map(asText) ( foo );; provided we have an inverted;; operator called doit abc foo quux doit another time;; will be translated toanother time doit(abc foo quux) Execution model 実行モデル The way an Ioke program works is very simple. Everything executes based on two things. The first is the context, or the ground, and the second is the receiver. The first message sent in each message chain will have the ground as receiver. The default ground in Ioke source files is an object calledGround. This object is in the mimic chain for most regular objects created in Ioke, which means that things defined at the top level will generally be available in most objects. Inside of methods and blocks, the ground will be different. Exactly in what way is defined by the type of code executing. Every message in a chain will be sent to the receiver of that message. That receiver is the result of the last message, or the current ground if there was no previous message, or if that previous message was a terminator. So Ioke code likefoo bar(flux bar) quuxinvolves 5 different messages. The messagefoois sent toGround, which is the current ground and also the default receiver. The messagebaris sent to the result of thefoomessage. The value returned will be activated. The cellbarcontains a method in this case, and that method expects one argument, so that forces evaluation of the arguments. The messagefluxis sent toGround, since it s the ground and there is no prior message inside of an argument list. The messagebaris sent to the result of thefluxmessage. The result of thebarmessage is used as the argument value given to the outsidebarmethod. The messagequuxis sent to the result of the initialbarmessage. The result of thequuxmessage is thrown away, unless this code is part of a larger piece of code. This description generally describes what happens in the case of this code. The more general control flow is this A message is encountered If the message is a symbol message, the corresponding symbol will be returned. Otherwise the name of the message will be looked up in the receiver, or in the receivers mimics. If the name is found and is not activatable, the value of that name (the cell) is returned. If the name is found and is activatable, it will be activated, with the current ground, receiver and message sent to the activatable object. If the name is not found, a second search is done for the namepass. If a pass is found, use that instead of the name of the original message, and go back to 4. If a pass is not found, signal aCondition Error NoSuchCellcondition. Exactly what happens when an object is activated depends on what kind of code gets activated. It s really up to the method, block or macro to handle evaluation of arguments in any way it likes - including not evaluating them. For a description of the default models available, see the chapter oncode. Objects オブジェクト The object model of Ioke is quite simple. Everything in Ioke is an object that follows these same rules. An object is something with an identity. It can have zero or more mimics, and zero or more cells. An object can also have a documentation text. Some objects can have a native data component. This acts more or less like a hidden cell that contains information that can t be directly represented in Ioke - for example the actual text in a Text. Or the actual number in a Number. Or the actual regular expression in a Regexp. These objects are the core types that contain primitive information. A cell is the main way of representing data in Ioke. A cell has a name and a value. Every value in Ioke is a cell - every time you send a message, a cell is looked up for the value of that cell. Cells can contain any kind of data. In other languages, cells are generally called properties or slots. They are quite close to instance variables that also can contain methods. Cells can be added and removed at any time during runtime. A mimic could also be called the parent of the object. Ioke is a prototype based language, which means that there is no distinction between classes of objects, and the objects themselves. In fact, any object can be used as the class of a new object. The word for that is mimicking, since the word class loses it s meaning in this kind of language. It s most common for an object to mimic one other object, at least initially. It s impossible to create an object that doesn t mimic anything, but you can remove all mimics for an object after the fact. You can also add more mimics. This turns out to be useful to represent shared functionality in the manner of Ruby mixins, for example. The actual effect of a mimic is that when a cell can t be found in the current object, all mimics will be searched for that cell (depth-first). So all cells available in an object s mimic is available to the object too. This is the inheritance part of Object-Oriented Programming. In many places you will find the word kind being used. A Kind is by convention an object that is used primarily to use as a mimic for other objects. The convention is that kinds are named with an initial upper case letter, while everything else starts with a lower case letter. The assignment process of Ioke also uses this convention to automatically set a cell called kind on any object that gets assigned to a name matching this convention. The rest of this chapter will discuss the kinds that are the basis of the object system. Base The kind called Base is the top of the mimic chain. It s not generally useful in itself as it only defines the bare minimum of cells to make it possible to add new cells to it, mimic it, and so on. But if you want an object that is possible to use but not include most of the other stuff, Base is place to begin. Be careful when defining methods in Base, since it doesn t have access to most of the namespace. In fact, it doesn t even know about its own name. Base can act as a kind of blank slate, if needed, but it s probably easier to just create a regular object and remove all mimics from it after the fact. Base defines these cells kind returns the kind of the object, which is Base . notice returns the short notice of the object, which is Base . Refer toIntrospectionfor more information about notice. = Takes two values, the first a place and the second a value, and assigns the place named to that value. Refer toAssignmentfor more information about it. == Compares this object against the argument. Returns true if they are the same, otherwise false. cell Takes one argument that should be the name of a cell that exists, and returns the value of the cell unactivated. cell= Sets a cell to a specific value. Used to set cells that can t be set using the regular assignment model. Refer toAssignmentfor more information about it. cell? Takes one argument that should be the name of a cell to check if it exists in this objects mimic chain. cellNames Returns a List containing the names of all cells this object contains. cells Returns a Dict with all cells this object contains. The key is the name and the value is the cell value. cellOwner Returns the closest mimic that has a cell with the name given as argument to the message. A condition will be signalled if you try to find the owner of a cell that doesn t exist in this mimic tree. This method will only return the closest cell owner for the named cell. It will not use pass , so it s the responsibility of pass-implementers to make it return a correct result for those names. cellOwner? Takes the name of a cell and returns true if the receiver of the message defines a cell by that name, otherwise false. Note that there can be more than one cell owner in a message chain. This just returns true if the current receiver is the closest one. removeCell! Removes the named cell from the current object. This means that if the current cell shadowed cells in mimics, those can be called again. It only removes a cell if the receiver is the owner of that cell. Otherwise it is an error to call this method. undefineCell! Makes it impossible to find a cell from the receiver. In all ways it looks like this cell doesn t exist in the mimic chain at all, even if mimics define several implementations of it. The use of undefining can make an object conceptually totally clean from cells, although it might be hard to use the objec after that. An interesting side-effect of the way these methods work is that removeCell! can be used to remove the undefine. So if you call removeCell! with a cell name and a receiver that has been called with undefine earlier, that undefine-status will be removed, and access to mimic versions of the cell will be possible again. Look at the specs for a better understanding. documentation Returns the documentation text for this object, or nil if no documentation exists for it. documentation= Sets the documentation text for this object. mimic Returns a newly created object that has the receiver as mimic. This is the magic way of creation new objects in Ioke. It is also theONLYway to do it. All of these methods are described further in the reference. Ground As mentioned above, Ground is the default ground/context for evaluation. Ground IokeGround and JavaGround, and IokeGround mimics Base and DefaultBehavior. IokeGround is special in that this is the place where all top level kinds are defined. If you want to create a top level kind, you should put it in IokeGround. If you take a look in IokeGround, you will see that it contains cells for Text, Dict, List, Base, Origin, itself and many other. Ioke doesn t have any global state at all, but IokeGround is as close as it gets. IokeGround and Ground should in most cases not be mimicked directly. JavaGround is the place where all Java integration support is integrated into Ioke. Origin Origin should be the place where most objects in Ioke start from. It is specifically created to be the origin of objects. As such it doesn t contain many cells for itself, but it mimics Ground and has access to everything from Base, DefaultBehavior and Ground in that way. When adding new more or less global functionality, Origin is probably the best place to put it. Currently, the only cells Origin contains is for purposes of printing itself. Origin also happens to be the point where initialization is defined. This is really done as an aspect on mimic . If you want an object to be able to be initialized every time a new mimic of it is created, just create a method called initialize in your kind. It will be called by the mimic-aspect. Any arguments given to mimic will be ignored and passed along to initialize. An example Foo=OriginmimicFooinitialize=method( New foo created! println)FoomimicFoomimicFooinitialize=method(arg1, key ,selfvalue=[arg1, key])Foomimic(42, key 15)Foomimic(key blarg ,42) There is nothing special with the initialize method, so if you want more initialization to happen in a deep hierarchy, you will have to use super-calls and so on. DefaultBehavior DefaultBehavior is a mixin - meaning it should never be the sole mimic of an object. Mixins are generally not grounded in Base, and doesn t contain most of the things you would expect from an object. DefaultBehavior contain almost all the general methods you use when programming Ioke. It contains the internal methods to create values from literals, and most other functionality specified in this document. In short, DefaultBehavior is the work horse, and you should have a pretty good reason to not have it in the mimic chain of an object. Since Ground mimics DefaultBehavior, any object you create from Origin, will have DefaultBehavior in its mimic chain. nil, true, false The three values nil, true and false are the only values that are considered kinds, even though they start with lower case letters. They are not like the other kinds in the other important way either - these values can not be mimicked, and you will get a condition if you try it. The reason is that Ioke s basic boolean system revolves around these values. It is not entirely certrain that these values will forever be the only boolean values, but for now they are. nil should be used to represent the absence of a value, including the absence of a reasonable return value. false is the quintessential false value, and true is the quintessential true value. The value true isn t strictly necessary since any value except for nil and false are true. This notion of truthness mimics Ruby. The cells nil, true and false are defined in Ground, and they can actually be overridden or changed - but I don t recommend it. I can guarantee lots of chaos and non-working programs from doing it. More info on how these values interact can be found in the section onComparison. Assignment 代入 Superficially, Ioke s assignment model is quite simple. But there exists some subtleties too. One of the main reasons for this is that assigning a cell that doesn t exist will create that cell. Where it gets created is different based on what kind of context the assignment happens in. The main difference here is between a method activation context, or a lexical block context. Ioke also supports assignment of places, which makes assigning much more flexible. A third feature of Ioke assignment is that it will check for the existence of an assignment method before assigning a specific name. This chapter will make all these things clear, and show some examples. Let s start with a small example of simple assignment foo=Originmimicfoo x=42foo y=13foo x+=2 The first line creates a new Origin mimic, and then assigns that to the name foo. Since this code executes at the top level, foo will be a new cell created in Ground. The second line creates a new cell called x inside the foo object. It gets assigned the value 42. The third line creates a y cell, and the fourth line sends the += message, which will first call +, and then assign using =. So at the end of this program, foo will contain two cells x with value 44, and y with value 13. As mentioned above, cells get created the first time they are assigned to. If you need to create a cell in a specific object, just namespace it. For example, if you want to make sure that you create a cell in Ground, just do Ground foo = 42 . Inside of a method, the situation is exactly the same. If you assign something, it will be assigned in the current context, which is the local activation context (meaning it s the place where local variables are available). There are two situations where this doesn t hold true. The first one is within the special method do . This method will take any code as argument and execute that with the receiver of the do message as the ground/context of the code inside it. That means do is a good way to create new cells inside an object. This is a bit academic, so lets take a look at an example Foo=OriginmimicFoox=method(;; this creates a local variable in the method activationfoo=42)Foo=OriginmimicFoodo(;; this creates the cell foo inside of Foofoo=42) Here you can see a method defined called x. This method will just create a new local cell, which means calling the method will not make any difference on its receiver at all. The call to do in contrast will immediately execute the code inside it, and this code will create the cell foo inside of Foo . The second exception to the general rule is when executing inside of a lexical context. A lexical context is basically established inside of a block, but can also be created transparently when sending code to a method. A lexical block will try to not create new cells. When you assign a cell without a specific place to assign it, a lexical block will first see if there is any cell with that name further out, and if so it will make the assignment there instead. Only when no such cell exists, a new cell will be created in the lexical context. This code shows this in action x=42fn(x=43. y=42)call x;; = 43y;; = Condition Error NoSuchCell The fn message creates a new lexical block. The chapter oncodewill talk more about this. But as you can see, this block assigns 43 to the cell x , and 42 to the cell y . But since the cell y doesn t exist, it will only be created inside the lexical context, while x exists outside, and will be assigned a new value instead. The basic idea is that code like this should behave like you expect it to behave. The canonical form of assignment is a bit different from the way you usually write code in Ioke. The section on the syntax of assignments talked a bit about this. Specifically, something like foo = 42 will get translated into =(foo, 42) . That also means that assignment is just a regular method call, and can be overridden or removed just like any other method. That is exactly how both lexical context, and local method context make it possible to have different logic here. This is true for all assignment operators. All assignment operators take as their first argument the place to assign to. This place will be unevaluated. Only the second argument to an assignment will be evaluated. In most cases, a place is the same thing as a cell name, but it doesn t have to be. Let s look at the case of assigning a cell with a strange name. Say we want to assign the cell with the no name. We can do it like this cell( )=42 What happens here is a bit subtle. Since the left hand side of the assignment takes arguments, the = method figures out that the assignment is not to a simple cell name, but to a place. The parsing step will change cell( ) = 42 into =(cell( ), 42) . Notice here that the argument comes along into the specification of the place. When this happens, the assignment operator will not try to create or assign a cell - instead it will in this case call the method cell=. So cell( ) = 42 will ultimately end up being the same as cell=( , 42) . This way of transforming the name will work the same for all cases, so you can have as many arguments as you want to the place on the left hand side. The equals sign will be added to the method name, and a message will be sent to that instead. This makes assignment of places highly flexible, and the only thing you need to do is implement methods with the right names. This feature is used extensively in Lists and Dicts to make it easy to assign to specific indexes. So, say we have a list called x. Then this code x[13] = 42 will be transformed into x =([](13), 42) which will in turn be transformed into x []=(13, 42) . Ioke lists also has an at= method, so you can do x at(13) = 42 which will call at=, of course. The second transformation that might happen is that if you try to assign a cell that has an assigner, you will call that assigner instead of actually assigning a cell. So, for example, if you do foo documentation = 42 , this will not actually create or assign the cell documentation . Instead it will find that Base has a cell called documentation= , and instead send that message. So the prior code would actually be equivalent to foo documentation=(42) . All of these assignment processes together make it really easy to take control over assignment, while still making it very obvious and natural in most cases. Let Sometimes you really need to change the value of something temporarily, but then make sure that the value gets set back to the original value afterwards. Other situations often arise when you want to have a new name bound to something, but maybe not for a complete method. This might be really useful to create closures, and also to create localized helper methods. For example, the Ioke implementations for Enumerable use a helper syntax macro. This macro is bound temporarily, using a let form. This ensures that the syntax doesn t stay around and pollute the namespace. A let in Ioke can do two different things, that on the surface look mostly the same but are really very different operations. The first one is to introduce new lexical bindings, and the second is to do a dynamic rebind of a specific place. The easiest way of thinking about it is that the lexical binding introduces a local change or addition to the available names you re currently using, while a dynamic rebinding will change the global state temporarily, and then set it back. This sounds really academic, so let us go for some examples. We begin with lexical bindings. ;; put everything in a method to show explicit scopefoo=method(x, y, x println; = argument value of xlet(x,14, x println; = 14)x println; = argument value of xy println; = argument value of yy=13y println; = 13let(y,14, y println; = 14)y println; = 13z println; will signal conditionlet(z,42, z println; = 42)z println; will signal condition) Here a new method is created that has two arguments, x and y. The first let-expression will create a new scope where a binding from x to 14 is established. This binding is valid until the end of the let-form (but it can be changed, doing an assignment will set the value to something else, but only until the end of the let form). The same thing is true with y. We can change the value of y outside of the let form. That changes the actual argument variable. But a let form that binds y will only have it active for a limited time. Finally, a let form can also create totally new variables, as when creating z. I didn t show any example of it, but the first part of a let-name can be any kind of place, not just a simple name. Anything you can use with =, can be used as a name for let. So you could do something like let(cell( ), 42, nil) if you wanted to. OK, so that s lexical binding. What about dynamic rebinding? The main difference in a dynamic binding is that the scope you work in is something that is referencable from other scopes. In most cases this will be global places, but not necessarily. You can also rebind cells inside of other objects with the dynamic binding feature. bar=method(let(Originfoo,method( haha println), x fooOriginfoo[1,2,3]foo)let(Textsomething,42, abc something println; = 42) abc something println; will signal conditionlet(Textinspect, HAHA , foo bar qux inspect println; = HAHA ) foo bar qux inspect println; = #[ foo bar qux ]let(TextasRational,method(42),(3+ haha )println; = 45)) This example actually changes things quite a lot. The first and second examples introduce new cells into existing places, uses them and then doesn t do anything. The third example actually overrides an existing cell in Text - inspect - and then uses it inside of the let code. Finally, after the let block is over, we see that the original method is back. The fourth example shows that our changes with let actually are global. There is no asRational on Text, but we add it temporarily and can then use it in arithmetic with numbers. This is once again a temporary change that will disappear afterwards. Ioke s let-form is incredibly powerful, and it allows very nice temporal and localized changes. Of course, it s a power that can be abused, but it gives lots of interesting possibilities for expression. Control flow 制御フロー Ioke has some standard control flow operators, like most other languages. In Ioke, all of these are regular method calls though, and they can usually be implemented in terms of Ioke. This chapter will chiefly talk about comparisons, conditionals and iteration constructs. Comparison 比較 There are several comparison operators in Ioke, but the most important is called the spaceship operator. This operator is = . It takes one argument and returns -1, 0 or 1 depending on the ordering of the receiver and the argument. If the two objects can t be compared, it returns nil. If you implement this operator and mixin Mixins Comparing, you get the operators ==, !=, , =, and = implemented in terms of the spaceship operator. There are two other common operators in Ioke. The first =~, which can also be called the match operator. It s only implemented for Regexp right now. The === operator also exists, but isn t implemented for most objects. This operator doesn t do much right now, but is planned to be the basis of a Ruby-like case-statement further down the line. The contract of comparison operators is that they should return a true value (not necessarily the true) if the comparison is true, and otherwise return either false or nil. The contract for === should be matching or not matching. It is among other things used in Ranges to see if something is included in that range or not. iik 1+2 4+ trueiik 3+2 4+ falseiik foo = fop + -1 Conditionals 条件分岐 Ioke has two different ways of doing conditionals. The first one is the default, and is also the traditional conditional from other languages. The second version looks more like Smalltalk conditionals. As with everything else, these conditionals are all methods, and can be overridden and changed if need be. They can also be polymorphic. The default conditionals are called if and unless . They both take an initial evaluated argument that is used to check which branch should be taken. The if method will execute it s second argument if the first argument is true, and the third argument if the first argument is false. The unless method does the inverse -- executing the second argument if the first argument is false, and the third argument if the first argument is true. One or both of the branches can be left out from the statement. If no else-part is around and the conditional part evaluates to a false value, that false value will be returned. A few examples are in order if(42 43, wow, math comparison works println, we have some serious trouble println)if(42 43, wow, math comparison works , we have some serious trouble )printlnunless(42 43, convoluted math println) It is good style to not use unless with an else branch. It generally tends to not be so readable that way. Remember that if and unless return their values, which means they are expressions like everything else. The middle example show that you can just call println on the result of the if-call, instead of doing it twice inside. This is also good style. Assigning the result of an if-call is likewise not a problem. In some languages you see a pattern such as if(foo = someExpensiveMethodCall(), foo println) , where a variable is assigned in the condition evaluation so the value doesn t have to be evaluated twice. This works in Ioke too, but there is a more idiomatic way of doing it. Both if and unless establish a lexical context, where a variable called it is available. This variable will be bound to the result of the conditional. So the above idiom could instead be written if(someExpensiveMethodCall(), it println) . This is the preferred way of handling regular expression matching. The Smalltalk inspired way of doing conditionals rest on the methods called ifTrue and ifFalse. Both of these methods are only defined on true and false, which means they are not as general as the if and unless statements. They can also be chained together, so you can write (42 43)ifTrue( wowsie! println)ifFalse( oh noes println) As should be obvious from these examples, these conditionals can not return any value. They must only rely on side effects to achieve anything. Ioke also supports the expected short circuiting boolean evaluators. They are implemented as regular methods and are available on all objects. All of the expected combinators are available, including and , , or , || , xor , nor and nand . cond Ioke doesn t have any else-if expression, which means that when you want to do several nested checks, you end up with lots of indentation. Cond is a macro that expands to that code. The code using cond will not have more indentation, which means it might be easier to read. A cond has one or more conditional expressions followed by an action part to execute if that condition is true. As soon as a condition has evaluated to true cond will not evaluate any more conditions or actions. If no conditions evaluate to true, nil will be returned, unless there is an action part following the last action-part. In other terms, if the cond-expression has an odd number of arguments, the last argument is the default case to execute if nothing else matches. Some examples of cond cond(x==1, one println, x==-1, minus one println, x 0, negative println, x 0, positive println, zero println) As you can see, it becomes quite clear what happens here. Keep in mind that cond is an expression, just like anything else in Ioke, and will return the last value evaluated. case A thing that you very often want to do is to check one value against several different conditions. The case expression allows this to be done succinctly. The core to the case-expression is the === method, that is used for matching. The expression takes one value, then one or more conditionals followed by actions, and then an optional default part. Once something matches, no more conditionals will be executed. The conditional part should not be a complete conditional statement. Instead it should return something that implements a fitting ===. So, a small example follows case(value,Text, it is a text! println, 1..10, it is a low number println, blurg, it is the symbol blurg println,fn(c,(c+2)==10), it is 8 println, we don t know it! println) The above example shows several different things you can match against, including a lexical block. The implementation of === for a lexical block will call the block with the value and then return true or false depending on the truth-value of the result of the call to the block. A thing that can be inconvenient in some languages is to do combinations of several of these. Say you want to check that something is a Text and matches a regular expression, or it is either 5..10 or 15..20. In most cases you will end up having to write several conditional parts for at least one of those two. But Ioke allows you to use combiners in the conditional part of a case expression. These combiners will be rewritten before executed, so a combiner called else will actually use the method case else , that in turn returns an object that responds correctly to ===. The end result is that using combiners read really well, and you can define your own by prefixing the name with case . There are several standard ones. Using a few of them looks like this case(value,and(Text,#/o+/), it s a text with several oos println,or(5..10, 15..20), numberific println, else, oh no! println) Combiners can be combined with each other and nested, so you could do and(foo, or(1, 2, 3), not(x)) if you want. The available combiners are these and Returns a matcher that returns true if all the arguments return true when calling ===. This is short circuiting. or Returns a matcher that returns true if any of the arguments return true when calling ===. This is short circuiting. not Takes one argument and returns the false if calling === on the argument returns true, and the other way around. nand The nand operation applied to === combiners. nor The nor operation applied to === combiners. xor The xor operation applied to === combiners. else otherwise Returns a matcher that always returns true. This is useful to make the default argument read better. Iteration 繰り返し Ioke supports most of the expected control flow operations for iteration. The one thing that is missing is the for-loop. Since the for-loop encourages low level stepping, and can be replaced by other kinds of operations, I don t see any reason in having it in Ioke. In fact, the for-statement in Ruby is generally considered bad form too. And if someone really wants a for-loop it s really easy to implement. For now I m reserving the name if I would like to add comprehensions at some point. loop For creating infinte loops, the loop -method is the thing. It will just take a piece of code and execute it over and over again until some non-local flow control rips the execution up. Using it is as simple as calling it loop( hello println)x=0loop(if(x 10,break)x++) The first example will loop forever, printing hello over and over again. The second example will increment a variable until it s larger then 10, and then it will break out of the loop. while The Ioke while loop works exactly like while-loops in other languages. It takes one argument that is a condition to reevaluate on each iteration, and another argument that is the code to evaluate each iteration. The result of the while-loop is the result of the last executed expression in the body. x=0while(x 10, x println x++) until The until-loop works the same as the while-loop, except it expects its condition argument to evaluate to false. It will stop iterating when the conditional is true for the first time. x=0until(x==10, x println x++) times A very common need is to iterate something a certain number of times. The Number Integer kind defines a method called times that does exactly this. It s got two forms - one with one argument and one with two arguments. With one argument, it will just run the argument code the specified number of times, and with two arguments the first argument should be the name of a cell to assign the current iteration value to and the second is the code to execute. 3times( hello println)4times(n, #{n} wow println) The first example will print hello three times, while the second example will count up from 0 to 3, printing the number followed by wow . each For most iteration needs, you want to traverse a collection in some way. The standard way of doing this is with the each -method. It s defined on all central collection classes and is also the basis of the contract for Mixins Enumerable. The contract for each has three different forms, and all should be implemented if you decide to implement the each method. The each method should -- as the name implies -- do something for each entry in the collection it belongs to. So calling each on a set would do something with each entry, etc. Exactly what that is depends on how many arguments are given to each . If one argument is given, it should be a message chain. This message chain will be applied to each element. [ one, two, three]each(inspect println);; the above would execute oneinspect println twoinspect println threeinspect println Another way of saying it is that the message chain will be executed using each element of the collection as receiver, in turn. The return value will be thrown away in this case, so to achieve anything, the code need to mutate data somewhere. The second -- and most common -- form, takes two arguments. The first argument should be the name of a cell to assign each element to, and the second argument should be the code to execute. Under the covers, this form will establish a new lexical context for the code to run in. As with the first version, each return value will be trown away. [2,4,6]each(x,(x*x)println) Here, the name x will be used as the name of each element of the list in turn, while executing the code. The final form of each takes three arguments, where the first is the name of a cell to assign the current index, and the other two arguments are the same as the above. [2,4,6]each(i, x, #{i} #{(x*x)} println) The above code would print 0 41 162 36 break, continue When executing loops it is sometimes important to be able to interrupt execution prematurely. In this cases the break and continue methods allow this for loop , while and until . Both break and continue work lexically, so if you send code to another method that uses these methods, they will generally jump out of a lexically visible loop, just like expected. The break method takes an optional value to return. If no value is provided it will default to nil. When breaking out of a loop, that loop will return the value given to break. The continue method will not break out of the execution, but will instead jump to the beginning and reevaluate the condition once again. while(true,break(42)) This code will immediately return 42 from the while-loop, even though it should have iterated forever. i=0while(i 10, i println if(i==5, i=7continue)i++) This code uses continue to jump over a specific number, so it will only print 0 to 5, and 7 to 9. Comprehensions 包含 Ioke s Enumerable mimic makes it really easy to use higher order operations to transform and work with collections of data. But in some cases the code for doing that might not be as clear as it could be. Comprehensions allow a list, set or dict to be created based on a more abstract definition of what should be done. The specific parts of a comprehension are generators, filters and the mapping. The generators are what data to work on, the filters chooses more specifically among the generated data, and the mapping decides what the output should look like. The following example does three nested iterations and returns all combinations where the product of the number is larger than 100 for(x -1..20, y -1..20, z -1..20, val=x*y*z, val 100,[x, y, z, val]) This code neatly shows all things you can do in a comprehension. The final argument will always be the output mapping, which in this case is a list of the three variables, and their product. The generator parts is first a name, the - operator followed by an expression that is Enumerable. You can also see that one of the expressions is an assignment, that can be used later. Finally, there is a conditional that limits what the output will be. The more or less equivalent expression using Enumerable methods would be 1..20 flatMap(x, 1..20 flatMap(y, 1..20 filter(z, x*y*z 100) map([x,y,z,x*y*z]))). In my eyes, the for-comprehension is much more readable. There are two variations on this. The first one is when you want the output to be a Set of things instead of a List. The code is exactly the same, except instead of using for, you use for set. There is also a for dict version, for more esoteric usages. Code コード Many of the things you do in Ioke will directly manipulate code. Since the messages that make up code is really easy to get hold of, this manipulation comes easy too. Ioke takes the Lisp philosophy of code is data to heart. The basic unit of a piece of code is a Message. A Message has a name, a next and prev pointer, and any number of arguments. When you manipulate a message, the argument list will contain messages too - and if the next or prev pointers are not nil, they will point to other messages. It serves well to remember that except for the message itself, all code will be evaluated in the context of a receiver and a ground. The ground is necessary because arguments to be evaluated need to be run in some specific context, even though the current receiver is not the same as the ground. The current types of code can be divided into three different categories. These are methods, macros and blocks. Native methods are all of the kind JavaMethod, but can have any kind of semantics - including semantics that look like macros. Most native methods do have the same semantics as regular methods, however. Methods メソッド A method in Ioke is executable code that is activatable. A method can take arguments of several different types. The arguments to a method will always be evaluated before the code in the method starts to execute. An Ioke method is defined using the method method. All Ioke methods have the kind DefaultMethod. This leaves the room open to define other kinds of methods, if need be. DefaultMethod s could be implemented using macros, but at this point they aren t. A DefaultMethod can have a name - and will get a name the first time it is assigned to a cell. It is really easy to define and use a simple method. The easiest case is to define a method that is empty. This method will just return nil m=method()m;; call the method Since methods are activatable, when you name a cell that contains a method, that method will be invoked. To stop that behavior, use the cell method. The definition of a method can take several different pieces. These are a documentation string, definitions of positional required arguments, definitions of positional optional arguments, definitions of keyword arguments, definition of a rest argument, definition of a keyword rest argument and the actual code of the method. Let s take these one by one. First, if the the first element of a call to method is a literal text, and there is at least one more argument in the definition, then that text will be the documentation text for the method ;; a method that returns foo m=method( foo );; a method that returns nil, but;; has the documentation text foo m=method( foo ,nil) A method can take any number of required positional arguments. These will be checked when a method is called, and if not enough -- or too many -- arguments are provided, an error will be signalled. m=method(x, x println)m=method(x, y, z, x*y+z) The first method takes one argument and prints that argument. The second method takes three arguments and return the product of the two first added to the third. A method can also have optional positional arguments. In that case the optional arguments must follow the required arguments. Optional arguments need to have a default value -- in fact, that is how you distinguish them from required arguments. The arity of method calls will still be checked, but using minimum and maximum values instead. The default value for an argument should be code that can be executed in the context of the running method, so a default value can refer to earlier positional arguments. A default value can also do quite complex things, if need be, although it s not really recommended. ;; takes zero or one argumentsm=method(x42, x println);; takes one to three argumentsm=method(x, y42, z25, x*y+z) The syntax for optional arguments is to just write a space after the name of the argument, and then write the code to generate the default value after it. A method can also have keyword arguments. Keyword arguments are checked, just like regular arguments, and you can t generally give keyword arguments to a method not expecting it. Nor can you give unexpected keyword arguments to a method that takes other keywords. Keyword arguments can never be required. They can have default values, which will default to nil if not provided. They can be defined anywhere among the arguments -- the only reason to reorder them is that default values of other optional arguments can use prior defined keyword arguments. A keyword argument is defined just like a regular argument, except that it ends in a colon. m=method(foo ,bar 42, foo println bar println) Just as with regular optional arguments, you supply the default value of the keyword argument after a space. The cells for the keyword arguments will be the same as their names, without the ending colon. The above code would print nil and 42 if no arguments were specified. It s important to remember that keyword arguments and positional arguments do not interact -- except for when calculating default values. When assigning values it s always possible to see what is positional and what is a keyword argument. Ioke methods can collect positional arguments into a list. This allow methods to take variable number of arguments. The rule is that all other positional arguments are first calculated, and the remaining positional arguments will be added to the rest argument. If no positional arguments are available, the rest argument will be empty. A rest argument is defined by preceding it with a plus sign in the argument definition. For clarity a rest argument should be defined last in the list, although it doesn t exactly matter anyway. m=method(+rest, rest println)m=method(x, y42,+rest, rest println) The above code defines one method that only takes one rest argument. That means the method can take any number of arguments and all of them will be collected into a list. The second method takes one required argument, one optional argument and any number of extra arguments. So if four arguments are given, the rest argument will contain two. The final type of argument is keyword rest arguments. Just like positional rest arguments, a keyword rest argument can collect all keywords given to a method, no matter what. If a keyword rest argument is used, no conditions will be signalled if an unknown keyword is given to a method. If other keywords are defined, these keywords will not show up in the keyword rest argument. The keyword rest argument is defined by preceding the name with a + sigil, and the keyword rest argument will be a Dict instead of a list. The keys will be symbols but without the ending colon. m=method(+ krest,krest println)m=method(x, y ,+rest,+ krest,[x, y, rest, krest]) The above code first creates a method that can take any number of keyword arguments but nothing else. The second method takes one required positional argument, one keyword argument, rest arguments and keyword rest arguments, and returns a new list containing all the arguments given to it. The final argument to the method method should always be the code to execute. This code will be executed in the context of a receiver, that is the object the method is activated on. A method execution also happens in the context of the method activation context, where local variables are stored. This activation context contain some predefined variables that can be used. These are self , @ , currentMessage and surroundingContext . Both self and @ refer to the receiver of the method call. currentMessage returns the message that initiated the activation of the method, and surroundingContext returns the object that represents the context where this method was called from. Both self and @ can be used to specify that something should be assigned to the receiver, for example. createNewCell=method(@foo=42) The method create above will create assign the value 42 to the cell foo on the object the method was called on. When calling a method, you specify positional arguments separated with commas. You can provide keyword arguments in any order, in any place inside the braces ;; the method foo takes any kind of argumentfoo foo()foo(1,2,3)foo(blarg 42,2,3,4)foo(quux 42*2) To give a keyword argument, you just write it exactly like you define keyword arugments - a name followed by a colon. Sometimes it can be useful to be able to take a list of values and give them as positional arguments. The same can be useful to do with a dict of names. You can do that using splatting. This is done by preceding a list or a dict with an asterisk. This will result in the method getting the values inside of it as if the arguments were given directly. You can splat several things to the same invocation. dc={foo 42, bar 13}ls=[1,2,3,4]ls2=[42,43,44]foo(*dc);; the same as foo(foo 42, bar 13)foo(*ls);; the same as foo(1,2,3,4)foo(*ls2,111,*dc,*ls);; the same as foo(42,43,44,111, foo 42, bar 13,1,2,3,4) If you try to splat something that can t be splatted, a condition will be signalled. Macros マクロ The main difference between a macro and a method in Ioke is that the arguments to a macro are not evaluated before they are sent to the macro. That means you have to use macros to send raw message chains in an invocation. In most languages, this kind of feature is generally called call-by-name. When a macro gets called, it will get access to a cell called call which is a mimic of the kind Call. This gives access to information about the call and makes it possible to evaluate the code sent as arguments, check how many arguments are supplied, and so on. A macro is created using the macro cell on DefaultBehavior. This will return a mimic of DefaultMacro. Since macros can t define arguments, it s a bit easier to describe than methods, but the things that can be done with macros are also a bit more interesting than what can be achieved with methods. One important thing to keep in mind is that most macros can not receive splatted arguments. In most cases keyword arguments aren t available either - but they could be faked if needed. Macros should generally be used to implement control structures and things that need to manipulate code in different ways. Just like a method, a macro gets evaluated on a specific receiver. It also gets the same kind of method activation context, but the contents of it is a bit different. Specifically, the context for a macro contains cells named self , @ , currentMessage , surroundingContext and call . It s the call cell that is most important. It is a mimic of Call, and Call defines several important methods for manipulating the call environment. These are arguments This method returns a list containing the unevaluated arguments given to this message. Any kind of manipulation can be done with these arguments. ground Returns the ground in which the call was initiated. This is necessary to evaluate arguments in their own environment. message The currently executing message. This is the same as the currentMessage cell in the macro activation context. evaluatedArguments Returns a list containing all arguments, evaluated according to the regular rules (but not handling splatting or keywords). resendToMethod Allows a specific message to be resent to another method, without manually copying lots of information. These methods are a bit hard to understand, so I ll take some examples from the implementation of Ioke, and show how macros are used here. MixinsEnumerablemap=macro( takes one or two arguments. if one argument is given, it will be evaluated as a message chain on each element in the enumerable, and then the result will be collected in a new List. if two arguments are given, the first one should be an unevaluated argument name, which will be bound inside the scope of executing the second piece of code. it s important to notice that the one argument form will establish no context, while the two argument form establishes a new lexical closure. , len=call arguments length result=list()if(len==1, code=call arguments firstselfeach(n, result code evaluateOn(call ground, cell( n))),code=LexicalBlockcreateFrom(call arguments, call ground)selfeach(n, result code call(cell( n))))result) The code above implements map, one of the methods from Enumerable. The map method allows one collection to be mapped in a predefined way into something else. It can take either one or two arguments. If one argument is given, that is a message chain to apply, and then collect the results. If two arguments are given, the first is the argument name to use, and the second is the code to execute for each entry. The first step is to figure out how many arguments have been given. This is done by checking the length of the call arguments cell. If we have a length of one, we know that the first argument is a piece of code to apply, so we assign that argument to a cell called code . Now, code will be a mimic of Message, and Message has a method called evaluateOn , that can be used to fully evaluate a message chain. And that s exactly what we do for each element in the collection we are in. The result of evaluateOn is added to the result list. We use call ground to get the correct ground for the code to be evaluated in. If we get two arguments, it s possible to take a shortcut and generate a lexical block from those arguments, and then use that. So we call LexicalBlock createFrom and send in the arguments and the ground, and then call that piece of code once for each element in the collection. It is a bit tricky to figure out how macros work. I recommend looking at the implementations of some of the core Ioke methods/macros, since these use much of the functionality. Blocks ブロック A lexical block allows the execution of a piece of code in the lexical context of some other code, instead of in a dynamic object scope. A lexical block does not have a receiver. Instead, it just establishes a new lexical context, and executes the code in that. The exact effect that has on assignments has beendescribedearlier. A lexical block can be created using either the fn or the fnx methods of DefaultBehavior. The main difference between the two is that a block created with fnx will be activatable, while something created with fn will not. Lexical blocks handle arguments exactly the same way as methods, so a lexical block can take optional arguments, keyword arguments, rest arguments and so on. Both fn and fnx also take optional documentation text. A block created with the fn method can be invoked using the call method of the kindLexicalBlock. x=fn(z, z println)x call(42) If a block created with the fn method takes one or more explicit parameters it can also be activated like a regular method. The reason for this is shown in the code snippet below. Here the result of invoking the block referred to by x is passed to y (which may be a regular method or even another block). If x would be fully non-activatable, x would be passed to y as is with the argument thrown away. In other words, that would be dead code. However, you can still refer to the block as x without an invocation to happen. x=fn(z, z+42)y(x(100));; activates the block with argument 100 and passes the result to yx;; refers to the block without activating it A block created with the fnx method is activatable per se and thus can be activated like a regular method. The default is to use fn to create inactive blocks though, since blocks are generally used to pass pieces of code around. y=fnx(z, z println)y(42) A lexical block is a regular kind of object that can be assigned to any cell, just like other objects. Lexical blocks mimic LexicalBlock, and blocks don t have names. In contrast to methods and macros, no extra cells will be added to the activation context for a lexical block. Lecros レクロ A macro works exactly like a method, in that it always has a receiver, and that receiver is available inside the macro as self and @ . In some circumstances it can be really useful to have a macro that behaves like a lexical block instead - being lexical so it can use cells defined outside of the definition of the macro. These macros won t have access to self or @ , since they don t have a receiver in that way. Where such a macro is called is only based on namespacing. Ioke supports these kind of macros. They are all mimics of the kind LexicalMacro, and they are created using the method lecro . A LexicalMacro is activatable by default, but a non-activatable lecro can be created using lecrox. The lecro method takes the same arguments as macro , and the only real difference is the way it handles outside cells and the receiver value. A lecro also has a cell called outerScope that can be used if you need to explicitly access something in the outer name space - such as call. Syntax 構文 Ioke supports loads of stuff with the standardmacro, but sometimes these are a bit too low level for commonly used operations. Syntax is one of those cases you can achieve the same goals with macros, but you don t really want to. Many features in Ioke S are implemented using syntax. You can define syntax using thesyntaxmethod. This returns a mimic ofDefaultSyntax. You can use the same kind of cells in a syntax as you can in a macro. What is different with syntax is that syntax can only return one of two things. The first isnil, and the second is a message chain. A syntax will only be executed once at every point in the message chains, because after a syntax executes the first time, it will replace itself with the result of that evaluation. If that evaluation returnsnil, syntax will just remove itself from the message chain. You can use this for many things, but one of the more useful things you can do is translate a high level declarative definition of something into a low level executable version. That is exactly how for comprehensions are implemented. Syntactic macros are fairly advanced, and take some time to grok. They are incredibly useful though, and they are used all over the standard library to achieve all manner of interesting things. Take a look there and things should hopefully become clearer. It s also a must to read the section on message chain manipulation and quoting in this guide to make syntax macros readable. Destructuring 構造の分解 A common problem with macros is that you want to take several different combinations of arguments, and do different things depending on how many you get. Say you might want to take one code argument, but also two optional arguments that should be evaluated. All of that code turns out to be highly repetetive, so Ioke contains a collection of syntax macros that make it easier to write these things. These are collectively called destructuring syntax. Let us say we have a macro that can be called with any of three types of argument list [code], [evaluatedArgument, code], or [evaluatedArgument, code, evaluatedArgument]. The stuff that should happen is totally different for each of these cases. With a regular macro the code would look something like this foo=macro(len=call arguments length case(len,1, code=call arguments[0]; do something with the code,2, arg1=call argAt(0)code=call arguments[1]; do something with the code and arg,3, arg1=call argAt(0)code=call arguments[1]arg2=call argAt(2); do something with the code and args)) As you can see it s really a lot of code to see what happens here, and it is very imperative in style. But, if I instead use dmacro - which is the destructuring version of macro - it looks like this foo=dmacro([code]; do something with the code,[ arg1, code]; do something with the code and arg,[ arg1, code, arg2]; do something with the code and args) dmacro will automatically check the length and extract the different arguments. The right arrow before the names of arg1 and arg2 marks that these should be evaluated. And what is more, dmacro will generate code that also generates a good condition if no argument matching works out. If you give zero arguments to the first version, it will fail silently. The dmacro will complain immediately. The dmacro destructuring syntax actually supports several more ways of ripping arguments apart. You can find this information in the doks for dmacro. Also, there are equivalent versions of dmacro for lecro, lecrox and syntax, called dlecro, dlecrox and dsyntax. They do the same thing, except they act like lecros or syntax instead. Message chains メッセージ鎖 In many cases a macro will take code that is not wrapped up inside of a method, macro or block. These pieces of code are called message chains, since their representation will be a raw Message mimic. The chains are quite flexible, since they can be taken apart, modified and put together again. They can also be unevaluated and used as data definitions of some kind. That s how the argument handling to methods are implemented, for example. Since the call to method can be seen as a regular call to a macro, the argument descriptions are actually just unevaluated message chains that are picked apart to tease out the argument names. The same technique is applicable in any macro usage. The term message chain fragment is also used to specifically mean a message chain that is meant to be put together with something and evaluated. Picture a daisy chain that gets added at the end of another chain and then executed. That s what happens if you execute something like[1, 2, 3] map(*2). In this case the call to*with the argument 2 will be a message chain fragment that will be put together with a new receiver before execution. To handle syntax correctly - but also to generally handle manipulation of message chains - it is important to know about the available methods to do this. I have added quite a lot of nice stuff that makes it easy to work with message chains. First, messages are actuallyEnumerable, so you can use anyEnumerablemethods on them. The enumeration always starts at the receiver. It will not proceed into arguments, just following the next-pointer. To create a new message or message chain, there are several helpful methods and operators. The first method is calledmessageand takes an evaluated name and returns a new message with that name.Message fromtakes one argument that will not be evaluated and returns a message chain corresponding to that argument.Message fromTextparses text and returns the message chain for it.Message wraptakes an evaluated argument and returns a message that will always return that value. As will be mentioned later, Message hasnext=andprev=methods that you can use to set the next and previous pointers. Message also hasappendArgumentandprependArgumentthat allow you to add new arguments to the message arguments. The most used versions for creating message chains are short cuts for the above. Let us begin with creation. Instead ofMessage fromyou can use . That is a single quote mark. The message after that will be unevaluated and returned as a message chain. If you use a `, a backtick, that is equivalent toMessage wrap. And then we have , that is two single quotes after each other. This message is generally called metaquote or quasiquote. It works the same as , except that it will find any place where ` is used and insert the value of evaluating the message after the ` and insert that into the current message chain. Finally, will replace a `` with a literal ` message. You can add new arguments to a message by using the operator. This operator returns the receiver. If you want to chain together a message chain, usingnext=andprev=is pretty tedious. You can instead use the - operator. This will chain together the left hand side and the right hand side messages, and return the right hand side message. I think it is time for some examples ; create a new message with name foox= foo; add two arguments to the foo messagearg= (bar quux)(x arg) baz; what we have done so far could be done with x= (foo(bar quux, baz))y= blurg; chain together x and yx- y; the above is equivalent toif(y prev, y prev next=nil)x next=y y prev=x val=42; insert the message chain in x (foo bar(`val)`x); the above will return the same as (foo bar(42)foo(bar quux, baz)) To understand these operators, you need to have a clear understanding of how the internals of message chains work. Once that clicks, these should be fairly straight forward to understand. Introspection and reflection 内部構造とリフレクション Ioke supports quite fancy introspection and reflection capabilities. In Ioke, reflection includes the ability to change data dynamically, as well as introspect on it. Since the message based structure of a program is available at runtime, most things can be changed dynamically. The internal structure of a program is also very easy to inspect. All objects in Ioke have some core methods that are used to look at them. Some come from Base, and some come from DefaultBehavior. The rest of the reflection and metaprogramming capabilities belong to the Message kind. kind Should be a text that gives the full name of the kind this object is closest mimic to. Except for nil, true and false, this will return a text that starts with a capital letter. Foo=OriginmimicFoomimickind printlnFooBar=OriginmimicFooBarmimickind println This code will first print Foo , and then print Foo Bar , since an object assigned to a cell with a capital initial letter will get a new kind value. kind? Takes one text argument and returns true if the object has that kind anywhere in its mimic chain. Foo = Origin mimic foo = Foo mimic foo kind?( foo );; false foo kind?( Foo );; true foo kind?( Text );; false foo kind?( Origin );; true foo kind?( Ground );; true foo kind?( DefaultBehavior );; true foo kind?( Base );; true As you can see in this example, kind? can return true for several different texts. notice When looking at objects, there are two ways to get information about them, notice and inspect. If you want a brief description of an object where it s important that the description doesn t take up much space, notice should be used. If an exhaustive description is needed, inspect should be used instead. For some objects these both return the same thing, but for Origin mimics, the difference is large. Foo=OriginmimicFoox= blarg Fooy=42Foonotice;; Foo_0x7CBDE6 The default notice for Origin mimics will combine the kind and the unique hex id for the object, and create a text of that. The notice method should be overridden to provide better information in most cases. inspect In contrast to notice, inspect is used to get exhaustive information. If a composite object is asked for its inspect, a quite large dump of information will often be shown. For a new object the output will be smaller, but usually still larger than the notice for it. Foo=OriginmimicFoox= blarg Fooy=42Fooinspect println This will print Foo_0x7CBDE6 kind = Foo x = blarg y =42 If another representation makes more sense for inspection, inspect should definitely be overridden by custom objects. uniqueHexId This method is used to return a text that contains a unique hex identity for an object. This text is guaranteed to be unique within a virtual machine for any object, and is the mechanism that inspect and notice uses. cellSummary Calling inspect on any Origin mimic will dispatch to cellSummary , which displays all the cell information about a specific object. cell The cell method can be used for two different things. The first one is to get access to a value without activating it, and the second is to get access to a cell based on a name that you don t know at the time you re writing the program. The cell method takes one argument that is the name of the cell to fetch. The fetching works the same as regular cell lookup, except that activation doesn t happen. This means that a condition will still be signalled if you try to get something that doesn t exist. x=42cell( x);; 42x=method()cell( x);; the method objectname= foocell(name);; the value of foo cell= Just as with cell , cell= can be used to set cells that you don t know the name of at the time of writing the program. As discussed in the chapter on assignment, cell= can also be used to set cells that can t be set in the regular way due to naming strangeness. cell? If you re not sure if a cell exists, using cell? is the way to find out. Give it a name and it returns true or false depending on if that cell exists. cellNames If you want to get the names of all the cells an object contains, you can get that with cellNames. By default, cellNames will only return the names of cells that belong to the receiver, but if an argument of true is sent to the call, the resulting list will contain the names of all cells of all mimics too. x=Originmimicx f=42x cellNames;; return [ f]x cellNames(true);; return a long list, including f cells Just like cellNames return the names of all the cells, the cells method will return a Dict of all the cells with their values. And just like cellNames, cells take an optional boolean argument on whether to include the cells of mimics too. x=Originmimicx f=42x cells;; return {f 42}x cells(true);; return a large dict, including f 42 mimics Returns a list of all direct mimics of the receiver. mimics? Takes one object as argument and returns true or false depending on if the argument is anywhere in the receiving objects mimic chain. message Takes one symbol argument and creates a new Message mimic with that argument as its name. Message code Returns a text that describes the code this message chain represents. It will hide some of the internal shuffling, but operators will be displayed using canonical form. Message formattedCode Returns a text that is formatted and indented in a canonical way. This method is used to generate the documentation code for DokGen, among other things. Message evalArgAt Takes the index of the argument to evaluate, and the ground to evaluate it on - returns the result of evaluating the argument. Message fromText Takes one text argument that should contain Ioke code, and returns the parsed message chain from that code, without evaluating it. Message doText Takes one text argument that should contain Ioke code, and returns the result of evaluating that code in the current context. Message filename Returns the filename where the receiving message was defined. Message line Returns the line number where the receiving message was defined. Message position Returns the position in the line where the receiving message was defined. Message name Returns the name of the message. The name of the message is what you generally talk about when saying you send a message. It can also be called the selector in other languages. Message name= Update the message with a new name. From this point on the message will only have that name, so doing this on a message that is part of an existing message chain will change the behavior of that code msg=MessagefromText( 2 + 1 )msg next name= - msg code;; 2 -(1) Message prev Returns the prev pointer of this message, or nil if no prev pointer exists. Message prev= Sets the prev pointer of a message. The new value should be either nil or another message. Message next Returns the next pointer of this message, or nil if no next pointer exists. Message next= Sets the next pointer of a message. The new value should be either nil or another message. Message sendTo Sends a message to an object. It s important to realize that sendTo will not evaluate the whole message chain -- it will only send one message with arguments to an object. Message keyword? Returns true if this message is a keyword message, and false otherwise. There are many more methods that can be used to do interesting introspection and reflection in Ioke. The reference documentation includes them all. Most of the interesting stuff can be found on the Message kind. send In many cases you want to activate something activatable in a cell, with a specific receiver. You can do this using send. You can send messages to most objects. Send takes one argument that should evaluate to the name of the message to send, and then sends along all other arguments given to send to the new message. These arguments will remain unevaluated, and will be evaluated at the leisure of the final method activated. Aspects アスペクト In many circumstances you might want to do several different things in a specific method. That generally goes against good software engineering, that says every piece of code should only have one responsibility. Aspect oriented programming tackles this by allowing you to slice code along a different dimension compared to the regular object oriented paradigm. Ioke has a small version of this, that allow you to add advice to cells. This advice can be before, after or around. All of them will get access to the arguments given in the original message, but after-advice also gets access to the value returned from the main cell. Finally, around-advice also gets the responsibility to invoke the original cell, so an around-advice could choose to not invoke it at all, or it could invoke it with different arguments, or maybe invoke it several times. Ioke currently only allows you to add or remove advice. To be able to remove advice, you need to name it when adding it. Unnamed advice can not be removed. Advice can be wrapped. It will be applied in an outside-in approach, where the most recently added advice will execute first. The return value of before and after advice doesn t matter, but the return value of around-advice will be interpreted as the new return value of the message send. To manipulate advice in Ioke, you need to describe what to manipulate. This description will return a Pointcut, that can then be used to inject advice at that point. Pointcuts can be defined in several ways. The easiest is to define it in terms of a cell name. Using this approach is the only way to define advice for non-existent cells. To create a Pointcut, call before, after or around on the receiver where the Pointcut should belong. The arguments specify what should be matched by the pointcut. You can see some examples of pointcuts here ; matches cells foo and barTextbefore( foo, bar)X=Originmimic; will not match anythingX around(matching anyFromSelf)X foo=123; will now match fooX around(matching anyFromSelf); any cell name matching the regexpX after(matching #/foo/); matches any at all, except fooX before(matching any,except foo); matches any at all, except anything that matches fooX before(matching any,except #/foo/); use a block for matchingX around(matching fn(x, x== blurg)); use a list to provide alternativesX before(matching [#/foo/,#/bar/]) As you can see from these examples, the pointcuts can be fairly advanced and specific in what they match. The option to send in a block makes it possible to check any property while matching. OK, once you have a Pointcut, there are three different methods you can call. These are , add, and remove!. The first one adds an unnamed advice, the second adds a named advice and the third one removes a named advice. Advice is any object that can be activated or called, so a method, a block, a macro or a syntax is fine. It s time to see what it looks like to add advice. Before-advice is the easiest kind. The important thing to remember is that the code will get the same arguments as the original call, which means it will also signal an error if the arguments doesn t match. X before( foo) method(x, got #{x} println)X before(matching anyFromSelf) macro( called #{call message name} println) This code doesn t do anything strange at all. Next up we have after-advice. The only difference here is that after-advice automatically gets a cell that is set to adviceResult, that can be used inside the method. X after( foo) method(+args, foo resulted in #{aspectResult} println) Remember that the result value of before and after advice doesn t count. It is thrown away. But these methods can still affect things by side effects. They can also be used for validation. A condition signalled inside of an advice would have the same effect as if done in the method itself - namely interrupting the flow of control. The final advice is around advice. These are different in two ways. First, they get access to a cell called aspectCall, which can be used to invoke the real cell (and the next chain of advice, of course). The second difference is that the result of the around advice will be the return value from the cell. So, you can imagine the around-advice executing instead of the original code. If you forget to invoke it, the original cell won t be invoked at all. X around( non_existant) method(42)X around( foo) macro(arg1, arg2, before println res=aspectResult(arg2, arg1) got #{res} println42) The first piece of code show that you can actually use an around advice around something that doesn t exist. But if you do call aspectCall inside of it, that will generate a NoSuchCell condition, of course. In the second example we first log some information, then invoke the original code with switched argument order, saves away the result, prints the result, and finally returns 42. There you can see most of the things that can be done inside of an around macro. The aspect system in Ioke is implemented in Ioke itself, and is fairly small at the moment. The guiding principle behind it is that it shouldn t have an impact on code that doesn t use it. It is a highly useful feature that makes it possible to decompose code substantially. As an example of a common place for aspect usage is initialization. This is defined as an around-advice that looks like this Originaround( mimic) method(+rest,+ krest,newMimic=aspectCall if(newMimic cell?( initialize),newMimic initialize(*rest,*krest))newMimic) Note first that the around advice takes any kind of arguments, but doesn t send them along to mimic. Instead it checks if there is an initialize-cell, and in that case invokes it with the arguments given to the mimic call. It finally returns the original result. Importing 外部コードの利用 To import new code into Ioke, the methoduseshould be used. The terminology is that you give use a name of a module to include, and if that module has already been included it will not be evaluated again. If it has not been included,usewill try to find the module using several different heuristics. It will add a.ikto the name and try to look up a file of that name - but it will also try to look it up without a.ik, if a full file name has been given. Several different places will be searched, and the exact order and what will be searched can be found by calling theSystem loadPathmethod. This will return a list of all the places that Ioke uses to search for modules. This list can be modified to add more directories to the load path at runtime. If a module of the specified name can t be found, a condition will be signalled. Core kinds よく使うkind Ioke obviously contains lots of different data types, but there are some that are much more important than others. In this chapter I ll take a look at these and talk about how to work with them correctly. Conditions One of the major parts of Ioke is the condition system. Unlike most other programming languages, Ioke doesn t have exceptions. Instead it has conditions, where errors are a specific kind of condition. The condition system comprises several different things. Specifically, the condition system uses the kinds Condition, Restart, Handler and Rescue. Restarts are mostly orthogonal to the rest of the system. The way the condition system works is this. When something happens, a program can elect to signal a condition. This can be done using signal! , warn! or error! . Both warn! and error! use signal! under the covers, but do some other things as well. A condition will always mimic Condition. Each of these three methods can be called in three different ways. First, you can call them with a text argument. In that case the signalled condition will be the default for that type. (The default for signal! is Condition Default. The default for warn! is Condition Warning Default and the default for error! is Condition Error Default.) A new mimic of the default condition will be created, and a cell called text will be set to the text argument. The second variation is to give an instance of an existing condition to one of the methods. In that case that condition will be signalled unmodified. Finally, the third version gives a condition mimic and one or more keyword arguments with data to set on that condition. In that case a mimic of the condition will be created, and then cells with data set based on the arguments. If a signal is not handled, nothing happens. If a warning is not handled, a message will be printed with the text of that warning. If an error is not handled, the debugger will be invoked - if a debugger is available. Otherwise the program will be terminated. A Rescue allows conditions to unwind the stack to the place where the rescue is established. Combining rescues and conditions looks a lot like regular exception handling in other programming languages. A Handler on the other hand will run code in the dynamic context of the place where the condition was signalled. A handler can invoke restarts to handle an error state at the place it happened, and as such doesn t have to actually unwind the stack anywhere. Any number of handlers can run - the last handler to run will be either the last handler, the handler that activates a restart, or the last handler before a valid rescue for that condition. A restart is a way to allow ways of getting back to a valid state. Take the example of referring to a cell that doesn t exist. Before signalling a condition, Ioke will set up restarts so you can provide a value to use in the case a cell doesn t exist. This restart will use that new value and continue execution at the point where it would otherwise have failed. A restart can have a name. If it doesn t have a name it can only be used interactively. You can use findRestart to get hold of the closest restart with a given name. You can invoke a given restart with invokeRestart, which takes either the name of a restart or a restart mimic. Finally, you can get all available restarts using availableRestarts. Both handlers, rescues and restarts are established inside a call to the bind macro. All arguments to this macro need to be either handlers, rescues or restarts, except for the last argument which should be the code to execute. You create a new handler by calling the method handle . You create a new rescue by calling the method rescue . You create a new restart by calling the method restart . These all take funky arguments, so refer to the reference to better understand how they work. This small example doesn t necessarily show the power of conditions, but it can give an idea about how it works. ;; to handle any problembind(rescue(fn(c,nil)),;; do nothing in the rescueerror!( This is bad!! ));; to print all conditions happening, but not do anythingbind(handle(fn(c, c println)), signal!( something )signal!( something more )warn!( A warning!! ));; rescue either of two conditionsC1=ConditionErrormimicC2=ConditionErrormimicbind(rescue(C1, C2,fn(c, got an error #{c} println)), error!(C1));; invoke a restart when no such cell is signaledbind(handle(ConditionErrorNoSuchCell,fn(c, invokeRestart( useValue,42))), blarg println);; will print 42;; establish a restartbind(restart(something,fn(+args, args println)), invokeRestart( something,1,2,3)) The code above shows several different things you can do with the condition system. It is a very powerful system, so I recommend trying to understand it. It lies at the core of many things in Ioke, and some parts will not make sense without a deep understanding of conditions. For more information on what such a system is capable of, look for documentation about the Common Lisp condition system, which has been a heavy influence on Ioke. Also, the debugger in IIk uses the condition system to implement its functionality. There are many conditions defined in the core of Ioke, and they are used by the implementation to signal error conditions of different kinds. Refer to the reference to see which conditions are available. Finally, one thing that you might miss if you re used to exceptions in other languages, is a construct that makes it possible to ensure that code gets executed, even if a non-local flow control happens. Don t despair, Ioke has one. It is called ensure, and works mostly like ensure in Ruby, and finally in Java. It takes one main code argument, followed by zero or more arguments that contain the code to always make sure executes. It looks like this ensure(conn=Databaseopen conn SELECT*FROM a_table, conn close!, conn reallyClose!, conn reallyReallyReallyClose!) This code uses a hypothetical database library, opens up a connection, does something, and then in three different ensure blocks tries to ensure that it really is closed afterwards. The return value of the ensure block will still be the return value of the last expression in the main code. Non local flow control can happen inside of the ensure block, but exactly what will happen is undefined -- so avoid it, please. Text In Ioke, the equivalent of Strings in other languages are called Text. This better describes the purpose of the type. Ioke Text is immutable. All operations that would change the text returns a new object instead. If you are used to Java strings or Ruby strings, then most operations available on Ioke Texts will not come as a surprise. To create a new Text, you use the literal syntax as described in the syntax chapter. You can use interpolation to include dynamic data. You can do several things with Ioke text. These examples show some of the methods ;; repeat a text several times foo *3;; = foofoofoo ;; concatenate two texts foo + bar ;; = foobar ;; get the character at a specific index foo [1];; = 111;; get a subset of text foo [1..1];; = o foo [0..1];; = fo foo [0...1];; = f foxtrot [1..-1];; = oxtrot foxtrot [1...-1];; = oxtro ;; is a text empty? foo empty?;; = false empty?;; = true;; the length of the text foo length;; = 3 length;; = 0;; replace the first occurrence of something with something else hello fox fob folk replace( fo , ba );; = hello bax fob folk ;; replace all occurrences of something with something else hello fox fob folk replaceAll( fo , ba );; = hello bax bab balk ;; split around a text foo bar bax split( );; = [ foo , bar , bax ] The Text kind contains lots of useful functionality like this. The purpose is to make it really easy to massage text of any kind. One important tool for doing that is the format method. This is a mix between C printf and Common Lisp format. At the moment, it only contains a small amount of functionality, but it can still be very convenient. Specifically you can print each element in a list directly by using format, instead of concatenating text yourself. The format method takes format specifiers that begin with %, and then inserts one of its arguments in different ways depending on what kind of format specifier is used. Some examples of format follow ;; insert simple value as text %s format(123);; = 123 ;; insert value right justified by 6 %6s format(123);; = 123 ;; insert value left justified by 6 %-6s format(123);; = 123 ;; insert two values %s %s format(123,321);; = 123 321 ;; insert a list of values formatted the same %[%s, %]\n format([1,2,3]);; = 1, 2, 3, \n ;; insert a dict of values formatted the same % [%s = %s, %]\n format({sam 3, toddy 10});; = sam = 3, toddy = 10, \n ;; insert splatted values from a list wow %*[%s %s %] format([[1,2],[2,3],[3,4]]);; = wow 1 2 2 3 3 4 Numbers As mentioned in the section on syntax, Ioke supports decimal numbers, integers and ratios. A Ratio will be created when two integers can t be divided evenly. A Ratio will always use the GCD. In most cases Ratios, Decimals and Integers can interact with each other as would be expected. The one thing that might surprise people is that Ioke doesn t have any inexact floating point data type. Instead, decimals are exact and can have any size. This means they are well suited to represent such things as money, since operations will always have well defined results. All expected math works fine on Ioke numbers. The reference for numbers more closely specify what is possible. One thing to notice is that the % operator implements modulus, not remainder. This might be unintuitive for some developers. What that means is that it is not an error to ask for the modulus of 0 13 % 0 , since there is no division necessary in this operation. In addition to the above, Integers have the times method described earlier. It can also return the successor and predecessor of itself with the pred and succ methods. Lists Ioke has lists that expand to the size needed. These lists can be created using a simple literal syntax. They can contain any kind of element, including itself (although don t try to print such a list). Ioke List mixes in the Enumerable mixin, which gives it quite powerful capabilities. A list can be created using the list or [] methods ;; an empty list[];; the same list created in two different wayslist(1,2,3)[1,2,3];; a list with different elements[1, one , one] Except for the Enumerable methods, List also defines many other methods that can be highly useful. Some examples are shown below l=[1,2,3];; add two lists togetherl+l;; = [1, 2, 3, 1, 2, 3];; return the difference of two listsl-[2];; = [1, 3];; add a new value to a listl 42l==[1,2,3,42];; = true;; get a specific element from the listl[0];; = 1;; -1 returns the last, -2 the next to lastl[-1];; = 42;; an index outside the boundaries return nill[10];; = nil;; assign a new valuel[3]=40l==[1,2,3,40];; = truel[-1]=39l==[1,2,3,39];; = true;; assign an out of bounds valuel[10]=13l==[1,2,3,39,nil,nil,nil,nil,nil,nil,13];; = true;; at and at= is the same as [] and []=l at(0);; = 1;; empty the listl clear! l==[];; = true;; follows the each protocoll each(println);; is empty?l empty?;; = true;; does it include an element?l include?( foo);; = false;; the last elementl last;; = nil[1,2]last;; = 2;; the length[1,2]length;; = 2;; first value[1,2]first;; = 1;; rest except for first[1,2,3]rest;; = [2, 3];; returns a new sorted list[3,2,1]sort;; = [1, 2, 3];; sorts in placel=[3,2,1]l sort! l==[1,2,3];; = true Dicts A Dict is a dictionary of key-value mappings. The mappings are unordered, and there can only ever be one key with the same value. Any kind of Ioke object can be used as a key. There is no problem with having the same value for different keys. The default implementation of Dict uses a hash-based implementation. That s not necessarily always true for all dicts. The iteration order is not necessarily stable either, so don t write code that depends on it. Creating a dict is done using either the dict or the {} methods. Both of these expect either keyword arguments or mimics of Pair. If keyword arguments, these keywords will be used as symbol keys. That s the most common thing, so it makes sense to have that happen automatically. Dicts also try to print themselves that way. dict(1= 2,3= 4);; these two are the samedict(foo bar , baaz quux )dict( foo= bar , baaz= quux ){1= 2,3= 4};; these two are the same{foo bar , baaz quux }{ foo= bar , baaz= quux };; the formats can be combined {1= 2, foo 42, bar = qux } The literal Pair syntax (using = ) will not necessarily instantiate real pairs for this. Dicts mix in Enumerable. When using each, what will be yielded are mimics of Pair, where the first value will be the key and the second will be value. Just like Lists, Dicts have several useful methods in themselves d={one two ,3= 4};; lookup with [], at works the samed[ one];; = two d[ two];; = nild[3];; = 4d[4];; = nil;; assign values with []=d[ one]= three d[ new]= wow! d=={one three ,3= 4, new wow! };; iterate over itd each(value println);; get all keysd keys==set( one, new,3) Sets If you want an object that work like a mathematical set, Ioke provides such a kind for you. There is no support for literal syntax for sets, but you can create new with the set method. A set can be iterated over and it is Enumerable. You can add and remove elements, and check for membership. x=set(1,2,3,3,2,1)x map(*2)sort; = [2, 4, 6]x===1; = truex===0; = falsex remove!(2)x===2; = falsex 4x===4; = true Ranges and Pairs Both ranges and pairs tie two values together. They also have literal syntax to create them, since they are very useful in many circumstances. A Range defines two endpoints. A Range is Enumerable and you can also check for membership. It s also convenient to send Ranges to the List [] method. A Range can be exclusive or inclusive. If it s inclusive it includes the end value, and if it is exclusive it doesn t. An addition to Ioke S is the possibility of inverted ranges. If the first value is larger than the second value, then the range is inverted. This puts slightly different demands on the objects inside of it. Specifically, if you want to iterate over the elements, the kind you re using need to have a method called pred for predecessor, instead of succ for successor. Membership can still be tested, as long as = is defined. So you can do something like this ( foo .. aoo ) === boo . It s mostly useful for iterating in the opposite direction, like with 10..1, for example. ;; literal syntax for inclusive range1..10;; literal syntax for exclusive range1...10;; check for membership(1..10)===5;; = true(1..10)===10;; = true(1..10)===11;; = false(1...10)===5;; = true(1...10)===10;; = false(1...10)===11;; = false;; get the from value(1..10)from==1;; = true(1...10)from==1;; = true;; get the to value(1..10)to==10;; = true(1...10)to==10;; = true;; is this range exclusive?(1..10)exclusive?;; = false(1...10)exclusive?;; = true;; is this range inclusive?(1..10)inclusive?;; = true(1...10)inclusive?;; = false A Pair represents a combination of two values. They don t have to be of the same kind. They can have any kind of relationship. Since Pairs are often used to represent the elements of Dicts, it is very useful to refer to the first value as the key , and the second value as the value . ;; literal syntax for a pair foo = bar ;; getting the first value( foo = bar )first;; = foo ( foo = bar )key;; = foo ;; getting the second value( foo = bar )second;; = bar ( foo = bar )value;; = bar Enumerable One of the most important mixins in Ioke is Mixins Enumerable - the place where most of the collection functionality is available. The contract for any kind that wants to be Enumerable is that it should implement each in the manner described earlier. If it does that it can mixin Enumerable and get access to all the methods defined in it. I m not going to show all the available methods, but just a few useful examples here. Note that any method name that ends with Fn takes a block instead of a raw message chain. Almost all methods in Enumerable take variable amounts of arguments and do different things depending on how many arguments are provided. The general rule is that if there is only one argument, it should be a message chain, and if there are two or more arguments the last one should be code, and the rest should be names of arguments to use in that code. Mapping a collection into a another collection can be done using map or mapFn. These are aliased as collect and collectFn too. l=[10,20,30,40];; mapping into textl map(asText);; = [ 10 , 20 , 30 , 40 ]l map(n, n asText);; = [ 10 , 20 , 30 , 40 ];; exponentiationl map(**2);; = [100, 400, 900, 1600]l map(n, n*n);; = [100, 400, 900, 1600] Filtering the contents of a collection can be done using select, which is aliased as filter and findAll. ;; with no arguments, return all true things[nil,false,13,42]select;; = [13, 42]l=[1,2,3,4,5,6];; all elements over 3l select( 3);; = [4, 5, 6]l select(n, n 3);; = [4, 5, 6] A very common operation is to create one object based on the contents of a collection. This operation has different names in different languages. In Ioke it is called inject, but it is aliased as reduce and fold. l=[1,2,3,4,5];; inject around a message chainl inject(+);; = 15l inject(*);; = 120;; with one argl inject(n,*n);; = 120l inject(n,+n*2);; = 29;; with two argsl inject(sum, n, sum*n);; = 120l inject(sum, n, sum*2+n*3);; = 139;; with three argsl inject(1, sum, n, sum*n);; = 120l inject(10, sum, n, sum*n);; = 1200 Regexps Regular expressions allow the matching of text against an abstract pattern. Ioke uses the JRegex engine to implement regular expressions. This means Ioke supports quite advanced expressions. Exactly what kind of regular expression syntax is supported can be found athttp //jregex.sf.net. This section will describe how you interact with regular expressions from Ioke. There are two kinds that are used when working with regular expression. First, Regexp, which represents an actual pattern. The second is Regexp Match, which contains information about a regular expression match. It is this match that can be used to extract most information about where and how a complicated expression matched. The standard way of matching something is with the match method. This method is aliased as =~, which is the idiomatic usage. It takes anything that can be converted to a text and returns nil if it fails to match anything, or a Regexp Match if it matches. You can create a new Regexp from a text by using the Regexp from method. You can quote all meta characters in a text by using the Regexp quote method. Finally, if you just want to get all the text pieces that match for a regular expression, you can use Regexp allMatches. It takes a text and returns a list of all the text pieces where the Regexp matched. You can also investigate a Regexp, by asking for its pattern (the pattern method), its flags (the flag method), and the named groups it defines. The names of the named groups can be inspected with the names method. A Regexp Match is specific to one specific match. You will always get a new one every time you try to match against something. A match has a target, which is the original text the regular expression was matched against. So if I do #/ .. / =~ abc fo bar , then the whole abc fo bar is the target. You get the target from a match by using the target method. A match can also be asked for the named groups the regular expression it was matched against support. This is also done with the names method. Match also has two methods beforeMatch and afterMatch, that returns the text before and after the match. The match method returns the text comprising the actual match. The captures method will return a list of all the captured groups in this match. The asList method returns the same things as captures, except it also includes the full match text. To figure out the indices where groups start or end, you can use the start or end methods. These take an optional index that defaults to zero, where group zero is the full match. They can also take a text or symbol that should be the name of a named group. The offset method returns a pair of the beginning and end offset of the group asked for. It works the same as start and end, with regards to what argument it takes. You can use the [] method on Match to extract the one or several pieces of matches. If m is a match, then all of these are valid expressions m[0]. m[1..3]. m[ foo]. m[-2], where the ranges return several groups, and the negative index returns indexed from the end of the list of captures. Finally, a Regexp Match implements pass. It does this in such a way that if you use named groups, you can extract the value for that group by calling a method named the same as that group name. An example of this number= 555-12345 m=#/({areaCode}\d{3})-({localNumber}\d{5})/=~number m areaCode println m localNumber println FileSystem The FileSystem kind allows access to functionality in the file system. It is the entry point to any manipulation of files and directories, and it can also be used to get listings of existing files. The reference includes good information about the existing methods in the FileSystem kind. Other things Ioke supports transforming an object into another object through the use of the method become!. After an object becomes another object, those two objects are indistinguishable from Ioke. This makes it really easy to do transparent proxies, futures and other things like that. To use it, do something like this x= foo y= bar x become!(y)x same?(y); = true In Ioke, objects can also be frozen. When an object is frozen it cannot be modified in any way. Any try at modifying a frozen object will result in a condition. This can be really helpful to track down problems in code, and make assertions about what should be possible. You freeze an Ioke object by calling freeze! on it. You can unfreeze it by calling thaw! on it. You can also check if something is frozen by calling frozen? on it. Java integration Javaとの統合 Java classes can be accessed by their full name, separated with colon instead of dots h = java util HashMap new You can invoke methods as expected, although the rules for this are a bit intricate. Specifically, the rules are that when calling methods that take any kind of primitive arguments (most of the types in java.lang), these values will be unwrapped. That means for a method taking an int, you can send in a wrapped Java Integer, but you can also send in an Ioke Number Rational, and it will be unwrapped correctly. You can send Text and Symbol to methods taking Strings. If you send in data to a method taking Object, you will not get the expected result in all cases. Specifically, in these cases Ioke will unwrap wrapped Java objects, but will not coerce the primitive types. So doingh put( foo , bar )will not coerce Text into java.util.String. However, if you have a java.lang.String that has been modified from the Ioke side - adding cells for example - then that String will be unwrapped before sent to the method call. The return value from a Java invocation will never be modified, except that null will always be changed into nil, and Java booleans will be transformed into Ioke booleans. This means that if you wrap a Java object, do some modifications to it, and then let it go through a Java call, what you will get back is probably not the wrapped version of that object. Of course, later on if you try to call a method on the object, you will still use the wrapped data. The general rule for overloading is that overloaded methods will be sorted from the most specific to the most general. Casts Ioke Java integration supports casts in the same way as Java does. The main difference is that the cast will be evaluated at runtime, not compile time. The name to cast to will be unevaluated. Valid names are either Object, String, any Java class name where dots are separated with colons, and a few special ones to handle primitive values. These names are byte, int, integer, long, short, char, character, float, double and boolean. Casting looks like this x=Foonew x bar((short)123,(org something Interface)anObj) Class methods Methods that belong to the Java class java.lang.Class are treated a bit differently from the way other Java methods work. The reason for this is a bit intricate to explain, but basically comes down to the dichotomy between the way mimicking works in Ioke, and the way inheritance works in Java. The easiest way to explain this might be to take a look at java.util.ArrayList. In Java the hierarchy looks like this (somewhat simplified) instance ArrayList - AbstractList - AbstractCollection - Object - Serializable - Cloneable - Iterable - Collection - List - RandomAccess Note here that all capitalized words are names of classes. The Class itself is not part of the inheritance structure, because Java has two namespaces. In Ioke, the above hierarchy basically ends up looking like this instance - ArrayList - Class - AbstractList - Class - AbstractCollection - Class - Object - Class - Serializable - Class - Cloneable - Class - Iterable - Class - Collection - Class - List - Class - RandomAccess - Class This is slightly simplified too, but the basic idea is that Class has to be part of the same inheritance chain, because there only exists one namespace in Ioke. And that is why there is a need to have these methods named differently. So, for example, say that you want to invoke thetoStringmethod onjava util HashMap. To do that, you do it like this java util HashMap class toString. Note that you can actually use theclass methods on instances of a class too. The result will be the same as if the receiver had been that class instead of the instance. Fields Accessing Java fields can be done by prepending the field name withfield . The exact mechanics of this is that a Java field will result in one or two Ioke methods. That means that the fields are not represented as cells directly on the object. If the field is not final, a setter will be also be generated for it. The setter follows the same rules as invocations of regular methods, with regards to casting and choice of unpacking of arguments. There is a slight gotcha with this scheme. If you try to set a field that is final, you will end up overwriting the accessor for that field - so it s important to be really careful to not set final fields. In the long run, it might be an idea to implement a setter that signals a condition when this happens, but doing that gives the impression that you can set the value - since the setter is there. Ioke doesn t care if a field is private or protected. All fields are accessible. A small example - say that you have a java object infoo. This Java object has two fields calledoneThingandanotherThing. Then you can work with it like this foo field oneThingprintln foo field anotherThing= Bar Systemout println(foo field anotherThing) Note that static fields work the same way - so you can access the Java streams directly like this, for example java lang Systemfield outprintln( some text ) Importing Ioke can import classes just as Java can. The way to do it looks a bit different, though. Also, in Ioke an import only means that a local name will be assigned to a class. It will not necessarily be globally visible, unless you import in a global scope. It s also important to keep in mind that imports will not happen if they might shadow or overwrite a name. If you want that, you will have to do a manual assignment instead. There are three ways of using the methodimport. The first one is simply to import one class with the same name as it already has ;; these are all equivalentHashMap=java util HashMapimport(java util HashMap)import java util HashMap;; you can also import directly into a scopefoo=Originmimicfoo import(java util LinkedHashMap)fooLinkedHashMap new Note that you can only give one class to import when using the above way. The second way to import is when you want to rename the imports. This allow you to import several classes from different packages and also rename them at the same time. This is done using keyword arguments to import ;; these are all equivalentFoo=java util HashMapBar=java lang Stringimport(Foo java util HashMap,Bar java lang String);; you can do the same in a new scope foo=Originmimicfoo import(Foo java util HashMap,Bar java lang String)fooFoonew The third way allow you to import several classes from the same package. Note that to use this way, you need to provide at least one class name, in addition to the package name ;; these are the same as the following importHashMap=java util HashMapLinkedList=java util LinkedListArrayList=java util ArrayListimport( java util, HashMap, LinkedList, ArrayList);; and just as above, you can do it in a scope toofoo=Originmimicfoo import( java util, HashMap, LinkedList, ArrayList)fooLinkedList new Java native arrays In general, working with Java native arrays work exactly like you would expect. The main difference is how you create them. For working with native arrays of primitive types, you can use the primitive type names, which are java byte,java short,java char,java int,java long,java floatandjava double. When setting or getting values from these arrays, they will work exactly like the coercions for regular Java methods. You can either create a new empty array, or you can initialize it based on an existing Ioke list x=java short[5]new x=java short[]from([1,2,3,4,5]) The first version creates a JavaArrayProxyCreator with dimension one, and length 5. The call tonewwill generate the actual array from this. You can create multidimensional arrays by adding new pairs of square brackets. In the second example, the call to square-brackets without an argument, will return the type of that array class. We then callfromon that type, which will take an Ioke list, and generate an equivalent Java native array. You can set and get values in Java arrays, just as you would with Ioke lists x=java char[10]new x[5]=10x[6]=13x[5]println Finally, Java native arrays implementeach, and mimicMixins Enumerable, which means that most things you expect to be able to do with them will work correctly. Adding jar-files to the CLASSPATH If you dynamically want to add new jar-files to the CLASSPATH, you can do that usinguse. There are two ways of doing it - you can either be implicit or explicit, depending on if the module name is unique to a jar-file or not use( the_jar_file )use( the_jar_file.jar )usejar( the_jar_file ) Implementing and extending Java types Ioke Esupports implementing Java interfaces from Ioke, and extending Java classes. This machinery is all done with the methodintegrate. Theintegratemethod takes one or more Java types (it doesn t matter if it s classes or interfaces, but it can only take at most one class), and then returns a new class that is magic in that it will proxy back all calls to the Ioke object, if it defines a method with the corresponding name. This scheme works for most things, but there are some things to keep in mind too. The most important one is that if you override a method that is overloaded in Java-land, it is the responsibility of the Ioke method to handle all the overloads. Using it is very simple IokeRunnable=integrate(java lang Runnable)IokeRunnable run=method( running! println)java lang Threadnew(IokeRunnable new) Note that you have to use thenewmethod to create new instances of this object. In this way it behaves exactly like regular objects in Java integration. And just in the same way, doing mimic will not copy the internal Java object, just the outwards Ioke object. Integration takes care of handling coercion of arguments and return values into what Java expects. Coercing lexical blocks to interfaces Ioke contains a mechanism that will automatically try to coerce anything code-like into an interface or abstract class if no other matching overload can be found for a method. So, that means you can do something like this, and it will work as expected javax swing JButtonnew addActionListener(fn(e, button pressed println)) Libraries ライブラリ Ioke ships with several small libraries that are useful for different tasks. The main ones are IIk, ISpec and DokGen, and these will be documented a bit more in this chapter. All of them are considered a core part of Ioke since the functionality they provide is tied to the distribution. IIk Main article Iik IIk is the interactive Ioke prompt, which will run if you give no arguments to the ioke script. At the IIk prompt you can execute mostly all the same kind of code that could execute inside of an Ioke script file. The main difference is that this code will not be assigned to Ground, but instead will run in another context that is specific for the purposes of IIk. ISpec Main article ISpec ISpec is a minimal port of the Ruby RSpec framework for behavior-driven development. It supports the bare minimum to allow testing of Ioke itself. The current Ioke test suite is completely written in ISpec, and it seems to be a capable environment. DokGen Main article DokGen DokGen is the tool that is used to generate the reference documentation for Ioke, and it generates output similar toRDoc. Its goal is to be a general purpose tool for any Ioke application. What is missing ないもの Ioke E is not a finished Ioke version. I seriously doubt Ioke will ever be complete. The core mechanics of the language I m feeling fairly confident in, but the core libraries are generally only partially implemented. They are much more complete than for the Ioke S release, but there still exist large holes in it. Concurrency support is missing, and so is any kind of advanced IO. Package management and other libraries like that is now starting to become necessary. Finally, alternative implementations for other platforms is also in the pipeline to happen sooner or later. There is aTodolist where we gather those things that should be done, sooner or later. Future plans 今後の予定 I have many plans for the future of Ioke. The next major version of Ioke will be calledIoke P. Exactly what it will contain we ll have to see, but feel free to add your requests and ideas toour TODO list. Retrieved from http //ioke.org/wiki/index.php/Guide Views Page Discussion View source History Personal tools Log in / create account News About Ioke Guide Download Project page Reference Resources Wiki Wiki Main Page Recent changes Search Toolbox What links here Related changes Special pages Printable version Permanent link This page was last modified on 5 April 2009, at 14 32. This page has been accessed 6,503 times. Content is available underGNU Free Documentation License 1.2. Privacy policy About IokeWiki Disclaimers