文档

你可以把Coffee-AHK看作是CoffeeScript的一种方言。它与现有的AHK代码兼容，并为其增加了诸如匿名函数、赋值解构乃至包管理支持等新功能。它同时也是CoffeeScript的子集，可以正确编译成JavaScript代码，并在全平台上运行。

最新版本：0.0.52

概览

上方为Coffee-AHK代码，下方为翻译后的AHK代码。

# assignment:
number = 42
opposite = true

# conditions:
if opposite then number = -42

# functions:
square = (x) -> x * x

# arrays:
list = [1, 2, 3, 4, 5]

# object:
math =
  root: Math.sqrt
  square: square
  cube: (x) -> x * square x

# splats:
race = (winner, runners...) ->
  print winner, runners

global number := 42
global opposite := true
if (opposite) {
  number := -42
}
global square := Func("ahk_3")
global list := [1, 2, 3, 4, 5]
global math := {root: Math.sqrt, square: square, cube: Func("ahk_2")}
global race := Func("ahk_1").Bind(print)
ahk_1(print, winner, runners*) {
  print.Call(winner, runners)
}
ahk_2(x) {
  return x * square.Call(x)
}
ahk_3(x) {
  return x * x
}

安装

# install locally for a project:
pnpm install coffee-ahk

语言参考

首先，Coffee-AHK使用有语义的空格和换行。你可以直接通过换行来终止表达式，而不需要显式书写;（除非你需要将多个表达式写在同一行）。而在函数、if语句、switch语句或try/catch中，你需要使用缩进替代包围代码块的{}来划分代码块。

在执行函数时，你不需要显式使用()来包裹参数。隐式调用会自动帮你处理好这些。

console.log sys.inspect object → console.log(sys.inspect(object));

函数

函数由括号中的参数、箭头和函数体三部分构成。一个最简单的空函数长这样：->。

注意，所有以大写字母开头的函数都被视作内置函数。

square = (x) -> x * x
cube = (x) -> square(x) * x

global square := Func("ahk_2")
global cube := Func("ahk_1")
ahk_1(x) {
  return square.Call(x) * x
}
ahk_2(x) {
  return x * x
}

函数参数可以设置默认值，当参数不传时（即为undefined时），其将被置为该值。

fill = (container, liquid = 'coffee') ->
  return "Filling the #{container} with #{liquid}..."

global fill := Func("ahk_1")
ahk_1(container, liquid := "coffee") {
  return "Filling the " . (container) . " with " . (liquid) . "..."
}

字符串

如同JavaScript和其他许多语言一样，Coffee-AHK同时支持'和"。Coffee-AHK也支持使用#{ ... }的形式，在"包裹的字符串中进行字符串插值，甚至在对象的键名中你也可以这么做。

author = 'Wittgenstein'
quote = "A picture is a fact. -- #{ author }"

sentence = "#{ 22 / 7 } is a decent approximation of π"

global author := "Wittgenstein"
global quote := "A picture is a fact. -- " . (author) . ""
global sentence := "" . (22 / 7) . " is a decent approximation of π"

Coffee-AHK中可以使用多行字符串。换行会被转为一个空格，而缩进则被忽略。

mobyDick = 'Call me Ishmael. Some years ago --
  never mind how long precisely -- having little
  or no money in my purse, and nothing particular
  to interest me on shore, I thought I would sail
  about a little and see the watery part of the
  world...'

global mobyDick := "Call me Ishmael. Some years ago -- never mind how long precisely -- having little or no money in my purse, and nothing particular to interest me on shore, I thought I would sail about a little and see the watery part of the world..."

html = '''
<strong>
  cup of coffee-ahk
</strong>
'''

global html := "<strong>cup of coffee-ahk</strong>"

双引号包括的块状字符串也可以进行插值。

对象与数组

Coffee-AHK中的对象与数组看起来同JavaScript非常相似。当每个属性都单独成行时，句末的,是可以省略的。你也可以使用缩进代替{}来创建对象，就像在YAML中那样。

song = ['do', 're', 'mi', 'fa', 'so']

singers = {Jagger: 'Rock', Elvis: 'Roll'}

bitlist = [
  1, 0, 1
  0, 0, 1
  1, 1, 0
]

kids =
  brother:
    name: 'Max'
    age: 11
  sister:
    name: 'Ida'
    age: 9

global song := ["do", "re", "mi", "fa", "so"]
global singers := {Jagger: "Rock", Elvis: "Roll"}
global bitlist := [1, 0, 1, 0, 0, 1, 1, 1, 0]
global kids := {brother: {name: "Max", age: 11}, sister: {name: "Ida", age: 9}}

在用同名变量来设置键时，你可以使用如下简便写法。注意，此时必须显式写下{和}。

name = 'Michelangelo'
mask = 'orange'
weapon = 'nunchuks'
turtle = {name, mask, weapon}
output = "#{turtle.name} wears an #{turtle.mask} mask. Watch out for his #{turtle.weapon}!"

global name := "Michelangelo"
global mask := "orange"
global weapon := "nunchuks"
global turtle := {name: name, mask: mask, weapon: weapon}
global output := "" . (turtle.name) . " wears an " . (turtle.mask) . " mask. Watch out for his " . (turtle.weapon) . "!"

注释

Coffee-AHK中使用#来表示行注释，使用###来表示块注释。

If, Else, Unless, and Conditional Assignment

if/else可以不使用{}包裹。你可以同其他块状表达式一样，使用缩进来划分它们。

if singing then mood = greatlyImproved

if happy and knowsIt
  clapsHands()
  chaChaCha()
else
  showIt()

if friday
  date = sue
else date = jill

if (singing) {
  mood := greatlyImproved
}
if (happy && knowsIt) {
  clapsHands.Call()
  chaChaCha.Call()
} else {
  showIt.Call()
}
if (friday) {
  date := sue
} else {
  date := jill
}

Splats, or Rest Parameters

gold = 'unknown'
silver = 'unknown'
rest = 'unknown'

awardMedals = (first, second, others...) ->
  gold = first
  silver = second
  rest = others

contenders = [
  'Michael Phelps'
  'Liu Xiang'
  'Yao Ming'
  'Allyson Felix'
  'Shawn Johnson'
  'Roman Sebrle'
  'Guo Jingjing'
  'Tyson Gay'
  'Asafa Powell'
  'Usain Bolt'
]

awardMedals contenders...

alert "
Gold: #{gold}
Silver: #{silver}
The Field: #{rest.join ', '}
"

global gold := "unknown"
global silver := "unknown"
global rest := "unknown"
global awardMedals := Func("ahk_1")
global contenders := ["Michael Phelps", "Liu Xiang", "Yao Ming", "Allyson Felix", "Shawn Johnson", "Roman Sebrle", "Guo Jingjing", "Tyson Gay", "Asafa Powell", "Usain Bolt"]
awardMedals.Call(contenders*)
alert.Call(" Gold: " . (gold) . " Silver: " . (silver) . " The Field: " . (rest.join.Call(", ")) . " ")
ahk_1(first, second, others*) {
  gold := first
  silver := second
  rest := others
}

循环

# Eat lunch.
eat = (food) -> "#{food} eaten."
for food in ['toast', 'cheese', 'wine']
  eat food

# Fine five course dining.
courses = ['greens', 'caviar', 'truffles', 'roast', 'cake']
menu = (i, dish) -> "Menu Item #{i}: #{dish}"
for dish, i in courses
  menu i + 1, dish

# Health conscious meal.
foods = ['broccoli', 'spinach', 'chocolate']
for food in foods
  if food isnt 'chocolate' then eat food

global eat := Func("ahk_2")
for __index_for__, food in ["toast", "cheese", "wine"] {
  eat.Call(food)
}
global courses := ["greens", "caviar", "truffles", "roast", "cake"]
global menu := Func("ahk_1")
for i, dish in courses {
  i := i - 1
  menu.Call(i + 1, dish)
}
global foods := ["broccoli", "spinach", "chocolate"]
for __index_for__, food in foods {
  if (food != "chocolate") {
    eat.Call(food)
  }
}
ahk_1(i, dish) {
  return "Menu Item " . (i) . ": " . (dish) . ""
}
ahk_2(food) {
  return "" . (food) . " eaten."
}

当循环对象时，使用of来替代in。

yearsOld = max: 10, ida: 9, tim: 11

ages = []
for child, age of yearsOld
  ages.Push "#{child} is #{age}"

global yearsOld := {max: 10, ida: 9, tim: 11}
global ages := []
for child, age in yearsOld {
  ages.Push("" . (child) . " is " . (age) . "")
}

# Econ 101
if @studyingEconomics
  while supply > demand
    buy()
  until supply > demand
    sell()

# Nursery Rhyme
num = 6
lyrics = []
while num
  num = num - 1
  lyrics.Push "#{num} little monkeys, jumping on the bed. One fell out and bumped his head."

if (this.studyingEconomics) {
  while (supply > demand) {
    buy.Call()
  }
  while !(supply > demand) {
    sell.Call()
  }
}
global num := 6
global lyrics := []
while (num) {
  num := num - 1
  lyrics.Push("" . (num) . " little monkeys, jumping on the bed. One fell out and bumped his head.")
}

until相当于while not，loop相当于while true。

操作符与别名

在Coffee-AHK中is相当于==，isnt相当于！=。

not相当于！的别名。

and相当于&&，or相当于||。

在while、if/else和switch/when语句中，then可以代替换行或分号，用于分隔表达式中的条件。

如同在YAML中那样，on和yes相当于true，off和no则相当于false。

unless可以视作if not。

你可以使用@property作为this.property的缩写。

为了简化数学表达式，你也可以使用**和//。

总而言之：

`Coffee-AHK`	`AHK`
`is`	`==`
`isnt`	`!=`
`not`	`!`
`and`	`&&`
`or`	`\|\|`
`true`, `yes`, `on`	`true`
`false`, `no`, `off`	`false`
`@`, `this`	`this`
`a ** b`	`a ** b`
`a // b`	`a // b`

if ignition is on then launch()

if band isnt SpinalTap then volume = 10

unless answer is no then letTheWildRumpusBegin()

if car.speed < limit then accelerate()

print inspect "My name is #{@name}"

if (ignition == true) {
  launch.Call()
}
if (band != SpinalTap) {
  volume := 10
}
if !(answer == false) {
  letTheWildRumpusBegin.Call()
}
if (car.speed < limit) {
  accelerate.Call()
}
print.Call(inspect.Call("My name is " . (this.name) . ""))

链式调用

使用行首.来更简单地使用链式调用。

$ 'body'
  .click (e) ->
    $ '.box'
      .fadeIn 'fast'
      .addClass 'show'
  .css 'background', 'white'

$.Call("body").click.Call(Func("ahk_1").Bind($)).css.Call("background", "white")
ahk_1($, e) {
  $.Call(".box").fadeIn.Call("fast").addClass.Call("show")
}

赋值解构

同JavaScript一样，Coffee-AHK支持赋值解构。当你将一个数组或对象文字赋值时，Coffee-AHK会将两边的值打散并相互匹配，将右边的值赋给左边的变量。这可以用于最简单的交换变量：

theBait = 1e3
theSwitch = 0

[theBait, theSwitch] = [theSwitch, theBait]

global theBait := 1000
global theSwitch := 0
global __array__ := [theSwitch, theBait]
theBait := __array__[1]
theSwitch := __array__[2]

或是实现非常实用的多返回函数：

weatherReport = (location) ->
  # Make an Ajax request to fetch the weather...
  return [location, 72, 'Mostly Sunny']

[city, temp, forecast] = weatherReport 'Berkeley, CA'

global weatherReport := Func("ahk_1")
global __array__ := weatherReport.Call("Berkeley, CA")
global city := __array__[1]
global temp := __array__[2]
global forecast := __array__[3]
ahk_1(location) {
  return [location, 72, "Mostly Sunny"]
}

类

由于AHK不区分大小写，请不要使用item = new Item()这种写法。而应该这么写：item2 = new Item()。

class Animal
  constructor: (name) -> @name = name

  move: (meters) ->
    alert @name + " moved #{meters}m."

class Snake extends Animal
  move: ->
    alert 'Slithering...'
    super.move 5

class Horse extends Animal
  move: ->
    alert 'Galloping...'
    super.move 45

sam = new Snake 'Sammy the Python'
tom = new Horse 'Tommy the Palomino'

sam.move()
tom.move()

class Animal {
  __New(name) {
    this.name := name
  }
  move := Func("ahk_3").Bind(alert).Bind(this)
}
class Snake extends Animal {
  move := Func("ahk_2").Bind(alert).Bind(this)
}
class Horse extends Animal {
  move := Func("ahk_1").Bind(alert).Bind(this)
}
global sam := new Snake("Sammy the Python")
global tom := new Horse("Tommy the Palomino")
sam.move.Call()
tom.move.Call()
ahk_1(alert, this) {
  alert.Call("Galloping...")
  base.move.Call(45)
}
ahk_2(alert, this) {
  alert.Call("Slithering...")
  base.move.Call(5)
}
ahk_3(alert, this, meters) {
  alert.Call(this.name + " moved " . (meters) . "m.")
}

Switch/When/Else

switch day
  when 'Mon' then go work
  when 'Tue' then go relax
  when 'Thu' then go iceFishing
  when 'Fri', 'Sat'
    if day is bingoDay
      go bingo
      go dancing
  when 'Sun' then go church
  else go work

switch day {
  case "Mon": {
    go.Call(work)
  }
  case "Tue": {
    go.Call(relax)
  }
  case "Thu": {
    go.Call(iceFishing)
  }
  case "Fri", "Sat": {
    if (day == bingoDay) {
      go.Call(bingo)
      go.Call(dancing)
    }
  }
  case "Sun": {
    go.Call(church)
  }
  default: {
    go.Call(work)
  }
}

Try/Catch/Finally

try
  allHellBreaksLoose()
  catsAndDogsLivingTogether()
catch error
  print error
finally
  cleanUp()

try {
  allHellBreaksLoose.Call()
  catsAndDogsLivingTogether.Call()
} catch error {
  print.Call(error)
} finally {
  cleanUp.Call()
}

模块

import './local-file.coffee'
import 'js-shim.ahk' # via npm

import fn from './source/fn'

import data from './data.json'
import data2 from './data.yaml

原生代码

如果你需要在代码中穿插一些原生AHK片段，你可以这么做：

hi = ->
  msg = 'Hello AHK'
  `MsgBox, % msg`

global hi := Func("ahk_1")
ahk_1() {
  msg := "Hello AHK"
  MsgBox, % msg
}

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

documentation.md

documentation.md

文档

概览

安装

语言参考

函数

字符串

对象与数组

注释

If, Else, Unless, and Conditional Assignment

Splats, or Rest Parameters

循环

操作符与别名

链式调用

赋值解构

类

Switch/When/Else

Try/Catch/Finally

模块

原生代码

Files

documentation.md

Latest commit

History

documentation.md

File metadata and controls

文档

概览

安装

语言参考

函数

字符串

对象与数组

注释

If, Else, Unless, and Conditional Assignment

Splats, or Rest Parameters

循环

操作符与别名

链式调用

赋值解构

类

Switch/When/Else

Try/Catch/Finally

模块

原生代码