변수와 표현식

변수가 표현식 안에서 퍼센트 사인에 둘러 싸여 있으면 (예, %Var%), 그 변수에 들어 있는 것은 어떤 것이든 또다른 변수의 이름이나 부분 이름으로 간주합니다 (그런 변수가 없다면, %Var%는 빈 문자열로 결정됩니다). 이런 일은 다음 예와 같이 의사-배열을 참조하는 데 자주 사용됩니다:

Var := MyArray%A_Index% + 100

하위 호환을 위해, "표현식일 수 있음"으로 문서화되어 있는 명령어 매개변수는 퍼센트 기호 안에 이름만 있는 변수에서 마치 퍼센트 사인이 없는 것처럼 취급합니다 (예, %Var%, 그러나 Array%i%는 아님). 괄호 안에 그 참조를 둘러싸면 이런 일을 피할 수 있습니다; 예, Sleep (%Var%).

[v1.0.90+]: 보통 변수 외에도, %Var%는 환경 변수, 클립보드, 또는 예약/읽기-전용 변수로 결정될 수 있습니다. revision 52이전에서, 이런 경우 %Var%는 빈 문자열을 산출했었습니다.

Unary minus (-): 뺄셈 연산자와 같은 심볼을 사용하지만, 단항 마이너스는 오직 하나의 항목에만 적용됩니다. 또는 다음 두 예제에서 보여주는 바와 같이 부분-표현식에만 적용됩니다: -(3 / -x). 관련하여 덧붙인다면, 표현식 안에서 단항 플러스 사인(+)은 무시됩니다.

Logical-not (!): 피연산자가 비어 있거나 0이면, 논리적-not을 적용한 결과는 1입니다. 참("true")이라는 뜻입니다. 그렇지 않으면 그 결과는 0입니다 (false). 예를 들어: !x or !(y and z). 주의: 단어 NOT은 !와 동의어입니다. 단 !가 더 우선 순위가 높습니다. v1.0.46+에서, !!Var와 같이 연속적인 단항 연산자가 허용됩니다. 왜냐하면 오른쪽에서 왼쪽 순서로 평가되기 때문입니다.

Bitwise-not (~): 피연산자의 각 비트를 뒤집습니다. 피연산자가 부동소수점 값이면, 먼저 정수로 자르고 나서 계산합니다. 피연산자가 0부터 4294967295 (0xffffffff) 사이이면, 부호 없는 32-비트 값으로 취급됩니다. 그렇지 않으면 부호 있는 64-비트 값으로 취급됩니다. 예를 들어, ~0xf0f는 0xfffff0f0 (4294963440)으로 평가됩니다.

Address (&): &MyVar는 메모리에서 MyVar의 내용이 있는 주소를 열람합니다. 이 주소는 전형적으로 DllCall 구조에 사용됩니다. &MyVar는 또 그 변수에 대한 이진 숫자를 캐싱하는 것을 불능으로 만듭니다. 수학 계산이나 숫치 비교에 사용되기라도 하면 수행성능이 떨어질 수 있기 때문입니다. 캐싱은 그의 주소가 바뀔 때마다 (예, VarSetCapacity()를 통하여) 재활성화됩니다.

Dereference (*): *Expression는 Expression이 숫치형 메모리 주소로 결정될 것이라고 간주합니다; 그 주소의 바이트를 0부터 255 사이의 숫자로 열람합니다 (주소가 0이면 언제나 0이 열람됩니다; 그러나 다른 무효한 주소는 모두 스크립트가 충돌할 수 있기 때문에 피해야 합니다). 그렇지만, NumGet()은 일반적으로 이진 숫자를 열람할 때 훨씬 더 수행성능이 좋습니다.

곱셈 (*): 입력이 모두 정수이면 그 결과도 정수입니다; 그렇지 않으면, 부동 소수점 수입니다.

실수 나눗셈 (/): EnvDiv와 다르게, 실수 나눗셈(true division)은 두 입력이 모두 정수라도 부동 소수점 수를 결과로 산출합니다. 예를 들어, 3/2는 1이 아니라 1.5를 산출하고, 4/2는 2가 아니라 2.0을 산출합니다.

바닥 나눗셈 (//): 이중-정사선 연산자는 두 입력이 모두 정수이면 성능이 높은 정수 나눗셈을 수행합니다. 예를 들어, 5//3는 1이고 5//-3은 -1입니다. 입력 중 하나가 부동 소수점 형식이면, 부동 소수점 나눗셈이 수행되고 그 결과는 왼쪽으로 가장 가까운 정수로 잘라냅니다. 예를 들면, 5//3.0은 1.0이고 5.0//-3은 -2.0입니다. 이 부동 소수점 나누셈이 결과가 정수임에도 불구하고, 부동 소수점 형식으로 저장됩니다. 그래서 그 값을 사용하는 것들은 모두 부동 소수점 수라고 인식합니다. 나머지 연산자(modulo)에 관한 것은 mod()를 참조합니다.

*= 연산자와 /= 연산자는 간략하게 한 변수 안의 값을 다른 값으로 곱하거나 나누는 방법입니다. 예를 들어, Var*=2는 Var:=Var*2와 같은 결과를 산출합니다 (그렇지만 전자가 수행성능이 더 좋습니다).

0으로 나누면 빈 결과 (빈 문자열)이 산출됩니다.

더하고(+) 뺍니다 (-). 관련해서 말씀 드리자면, += 그리고 -= 연산자는 간략하게 변수를 증가시키거나 감소시키는 방법입니다. 예를 들어, Var+=2는 Var:=Var+2와 같은 결과를 생산합니다 (그렇지만 전자가 더 수행성능이 좋습니다). 비슷하게, Var++, Var--, ++Var, 또는 --Var을 사용하면 변수를 1씩 증가시키거나 감소시킬 수 있습니다.

결합. 점(dot) 연산자는 두 개의 항목을 하나의 문자열로 결합하는 데 사용됩니다 (점의 양쪽에 적어도 하나의 공간이 있어야 합니다). 점을 생략해도 같은 결과를 얻을 수 있습니다 (단 x -y와 같이 애매하거나, 오른쪽에 있는 항목 앞에 ++ 또는 --이 있는 경우는 제외합니다.). 점이 생략되면, 병합될 항목 사이에 적어도 공간 하나가 있어야 합니다.
예제 (표현식 방법): Var := "The color is " . FoundColor
예제 (전통적 방법): Var = The color is %FoundColor%

하위-표현식도 역시 결합할 수 있습니다. 예를 들어: Var := "The net price is " . Price * (1 - Discount/100).

점으로 (또는 기타 다른 연산자로) 시작하는 줄은 자동으로 윗 줄에 추가됩니다.

할당. 변수의 내용에 연산을 수행하고 그 결과를 다시 같은 변수에 저장합니다 (그러나 1.0.46 이전 버전에서는 한 줄 위에서 가장 왼쪽 연산자로만 사용할 수 있었습니다. 그리고 연산자를 앞쪽 다섯 개까지만 지원했습니다.). 가장 단순한 할당 연산자는 쌍점-등호 (:=)입니다. 표현식의 결과를 변수에 저장합니다. 다른 연산자들이 어떤 일을 하는지 그 설명은 이 표에서 관련 엔트리를 참조하십시오. 예를 들어, Var //= 2는 바닥 나눗셈을 수행하여 Var를 2로 나눈 다음, 그 결과를 다시 Var에 저장합니다. 비슷하게, Var .= "abc"는Var := Var . "abc"를 간략하게 작성한 것입니다.

대부분의 다른 연산자와 다르게, 할당은 오른쪽에서 왼쪽으로 평가됩니다. 결과적으로 Var1 := Var2 := 0와 같은 줄은 제일 먼저 0을 Var2에 할당한 다음 Var2를 Var1에 할당합니다.

할당을 다른 연산자의 입력으로 사용하면, 그의 값은 변수 자체입니다. 예를 들어, 표현식 (Var+=2) > 50는 Var에 새로-증가된 값이 50을 초과할 경우에만 참입니다. 이렇게 하면 할당을 ByRef로 건넬 수 있는데, 즉, 그의 주소로 건넬 수 있습니다; 예를 들어: &(x:="abc").

할당 연산자의 우선순위는 구문 에러를 피하거나 보다 직관적인 행위를 제공하면 자동으로 높아집니다. 예를 들어: not x:=y는 not (x:=y)로 평가됩니다. 비슷하게, ++Var := X는 ++(Var := X)으로 평가됩니다; 그리고 Z>0 ? X:=2 : Y:=2는 Z>0 ? (X:=2) : (Y:=2)으로 평가됩니다.

하위 호환의 문제 때문에 야기되는 알려진 제한이 있습니다 (미래의 버전에서는 해결될 수 있습니다):

1. /=가 표현식에서 가장 왼쪽의 연산자이고 다중-서술문 표현식의 일부가 아니면, 바닥 나눗셈(floor division)을 수행합니다. 입력 중 하나라도 부동 소수점 수가 아니어야 합니다 (다른 경우는 모두, /=는 실수 나눗셈(true division)을 합니다.);
2. 날짜/시간 계산을 +=과 -= 이 지원합니다. 그러나 오직 그 연산자가 한 줄의 가장 왼쪽에 홀로 있을 때만 지원합니다;
3. 연산자 +=, -=, 그리고 *= 는 빈 변수를 0으로 취급합니다. 그러나 한 줄에 홀로 있을 경우에만 그렇습니다; 예를 들어, y:=1, x+=1와 MsgBox % x-=3는 둘 다 x가 비어 있을 때 빈 결과를 산출합니다.

쉼표 (다중-서술문) [v1.0.46+]. 쉼표를 사용하면 여러 하위 표현식을 한 줄에 작성할 수 있습니다. 다중 할당이나 함수 호출을 그룹짓는데 자주 사용됩니다. 예를 들어: x:=1, y+=2, ++index, func(). 그런 서술문들은 왼쪽에서 오른쪽으로 순서대로 실행됩니다. 주의: 쉼표로 (또는 다른 연산자로) 시작하는 줄은 자동으로 윗 줄에 추가됩니다. 다음도 참조하십시오: 쉼표의 연산 성능.

v1.0.46.01+에서, 쉼표 다음에 곧바로 변수가 따라 오고 다음에 등호 사인이 오면, 그 등호 사인은 자동으로 할당 (:=)으로 취급됩니다. 예를 들어, 다음은 모두 할당입니다: x:=1, y=2, a=b=c. 새 스크립트는 이 행위에 의존하면 안 됩니다. 나중에 변경될 수도 있기 때문입니다. 규칙은 오직 평범한 변수에만 적용될 뿐 이중-참조(double-derefs)에는 적용되지 않습니다. 그래서 다음은 오직 하나의 할당만 담겨 있습니다: x:=1, %y%=2

mod()
round()
abs()

[v1.0.90+]: 객체 func에서 빈 이름의 메쏘드를 호출하려고 시도합니다. 관례적으로, 객체의 "기본" 메쏘드가 호출됩니다. func에 객체가 없다면, 대신에 기본 베이스 객체가 요청됩니다.

[v1.0.95+]: func에 함수 이름이 있다면, 그 함수가 호출됩니다.

스크립트 안에서 현재 실행중인 줄의 번호입니다 (또는 그의 #Include 파일 중 하나입니다). 이 줄 번호는 ListLines이 보여주는 줄 번호와 일치합니다; 다음 예제와 같이 에러를 보고할 경우에 유용하게 사용할 수 있습니다: MsgBox 로그 파일에 기록할 수 없었음 (줄 번호: %A_LineNumber%).

컴파일된 스크립트는 자신의 모든 #Include 파일들을 하나의 커다란 스크립트로 병합해 넣기 때문에, 비-컴파일 모드에서 실행할 때와 줄 번호가 다를 수 있습니다.

비-컴파일 스크립트라면: 현재 스크립트를 실제로 실행중인 EXE 파일의 이름과 전체 경로입니다. 예를 들어: C:\Program Files\AutoHotkey\AutoHotkey.exe

컴파일된 스크립트라면: 위와 같지만 예외는 AutoHotkey 디렉토리가 레지스트리 HKEY_LOCAL_MACHINE\SOFTWARE\AutoHotkey\InstallDir 엔트리를 통하여 발견된다는 것입니다. 그런 엔트리가 없다면, A_AhkPath는 비어 있습니다.

A_YWeek의 정밀한 정의: 1월 1일을 담고 있는 주가 새 해에서 4일 이상을 가지면, 그것을 1 번 주로 간주합니다. 그렇지 않으면, 이전 년도의 마지막 주이고, 다음 주가 1 번 주입니다.

현재 2-자리 분 (00-59).

컴퓨터가 리부팅된 이후로 경과한 밀리초의 개수. A_TickCount를 변수에 저장해 두고 나중에 가장 마지막 A_TickCount 값에서 빼어서 경과한 시간을 측정할 수 있습니다. 예를 들어:

StartTime := A_TickCount
Sleep, 1000
ElapsedTime := A_TickCount - StartTime
MsgBox,  %ElapsedTime% 밀리초가 경과하였습니다.

A_TickCount의 밀리초보다 더 정밀해야 한다면, QueryPerformanceCounter()를 사용합니다.

알려진 한게: 스크립트가 처음부터 상대적인 경로를 시스템 DLL에 건넸다면 이 경로는 올바르지 않을 수 있습니다; 예를 들어, Menu, Tray, Icon, user32.dll, 2.

위와 비슷하지만 상응하는 갈고리가 설치되어 있으면 인위적인 키눌림과 마우스 클릭을 무시합니다. (keyboard 또는 mouse); 즉, 오직 물리적 이벤트에만 응답합니다. (마치 사용자가 존재하는 듯이 키보드나 마우스 클릭을 흉내내는 것을 방지합니다.) 갈고리가 설치되어 있지 않으면, 이 값은 A_TimeIdle과 동등합니다. 둘 중에 하나의 갈고리만 설치되어 있으면, 물리적 입력의 유형만 A_TimeIdlePhysical에 영향을 미칩니다 (다른/설치-안된 갈고리의 입력은, 물리적 입력과 인위적 입력에 모두 영향이 없습니다).

1. A_Gui가 비어 있다;
2. GUI 메뉴 바 항목이나 GuiClose/GuiEscape과 같은 이벤트가 현재 쓰레드를 기동시켰다;
3. 콘트롤에 연관 변수가 없으며 캡션도 없다;
4. 또는 현재 쓰레드를 기동시킨 최초의 콘트롤이 (아마도 Gui Destroy 때문에 더 이상 존재하지 않는다).

현재 쓰레드를 기동한 이벤트의 종류. 쓰레드가 GUI 행위를 통하여 기동되지 않았다면, 이 변수는 비어 있습니다. 그렇지 않으면, 다음 문자열 중 하나가 담깁니다:

Normal: 이벤트가 왼클릭 또는 키눌림으로 기동되었습니다 (화살표 키, TAB 키, 스페이스바, 밑줄 단축키 등등.). 이 값은 또GuiClose 그리고 GuiEscape와 같은 특수한 이벤트 그리고 메뉴 바 항목에도 사용됩니다.

DoubleClick: 이벤트가 더블클릭으로 촉발되었습니다. 주의: 클릭-쌍 중에 첫 클릭은 먼저 Normal 이벤트를 받습니다. 다시 말해, 서브루틴은 두 번 기동됩니다: 한 번은 첫 클릭에 그리고 다시 두 번째 클릭에 기동됩니다.

RightClick: 오직 GuiContextMenu, ListViews, 그리고 TreeViews에만 일어납니다.

문맥-감지 값: 자세한 것은 GuiContextMenu, GuiDropFiles, Slider, MonthCal, ListView, 그리고 TreeView를 참조하십시오.

다음 이벤트들에 대한 추가 정보를 담고 있습니다:

• OnClipboardChange 라벨
• 마우스 휠 핫키 (WheelDown/Up/Left/Right)
• RegisterCallback()
• GUI events, 즉 GuiContextMenu, GuiDropFiles, ListBox, ListView, TreeView, 그리고 StatusBar. 이벤트에 대하여 더 이상 추가 정보가 없으면, A_EventInfo에는 0이 담깁니다.

가장 최근에 실행된 핫키 또는 비-자동-교체 핫스트링입니다 (없으면 비어 있습니다). 예, #z. 이 값은 현재 쓰레드가 또다른 핫키로 인터럽트 되면 변합니다. 그래서 나중에 서브루틴에서 사용하기 위해 원래 값이 필요하다면 즉시 또다른 변수에 복사하십시오.

핫키가 처음으로 - 스크립트에서 핫키 명령어나 이중-쌍점 라벨로 -- 만들어질 때, 그의 키 이름과 그의 수식 심볼의 순서가 그 핫키의 영구적인 이름이 됩니다. 그 이름을 핫키의 모든 변형들이 공유합니다.

다음도 참조하십시오: A_ThisLabel

다음 문자열 중 하나입니다: WIN_7 [requires v1.0.90+], WIN_8 [requires v1.1.08+], WIN_8.1 [requires v1.1.15+], WIN_VISTA, WIN_2003, WIN_XP, WIN_2000.

호환성 설정을 오토핫키 실행파일이나 컴파일된 스크립트의 특성에 적용하면 운영체제가 다른 버전 번호를 돌려줍니다. 이것이 A_OSVersion에 반영됩니다.

[v1.1.20+]: OS 버전을 위에 언급한 리스트에서 찾을 수 없으면, 문자열이 "major.minor.build" 형태로 반환됩니다. 예를 들어 10 TP는 6.4.9841입니다.

; 이 예제는 폐기되었습니다. 이 운영체제는 더 이상 지원하지 않습니다.
if A_OSVersion in WIN_NT4,WIN_95,WIN_98,WIN_ME  ; 주의: 쉼표 둘레에 스페이스가 없음에 주의합니다.
{
    MsgBox 이 스크립트는 Windows 2000/XP 이상을 요구합니다.
    ExitApp
}

현재 사용자가 관리자 권한이 있으면, 이 변수는 1, 그렇지 않으면 0이 담깁니다.

윈도우즈 비스타 이후에서 어떤 스크립트는 적절하게 기능을 발휘하기 위해 관리자 권한을 요구합니다 (예를 들어 프롯스나 창과 상호작용하는 스크립트는 관리자 권한으로 실행됩니다). 이렇게 하려면, 다음을 스크립트의 상단에 추가하십시오:

if not A_IsAdmin
{
   Run *RunAs "%A_ScriptFullPath%"  ; Requires v1.0.92.01+
   ExitApp
}

A_ScreenWidth
A_ScreenHeight

기본 모니터의 너비와 높이, 픽셀 단위 (예, 1024 그리고 768).

다중 모니터 시스템에서 다른 모니터의 크기를 알려면, SysGet를 사용합니다.

대신에 (다중 모니터에 걸쳐 있더라도) 전체 데스크탑의 너비와 높이를 알려면, 다음 예제를 사용합니다:

SysGet, VirtualWidth, 78
SysGet, VirtualHeight, 79

게다가, SysGet을 사용하면 모니의 작업 영역을 알 수 있습니다. 모니터의 전체 영역보다 더 작을 수 있습니다. 왜냐하면 태스크바와 기타 등록된 데스크탑 툴바가 배제되어 있기 때문입니다.

현재 화면에 보여지는 마우스 커서의 유형입니다. 다음 단어 중 하나입니다:
AppStarting, Arrow, Cross, Help, IBeam, Icon, No, Size, SizeAll, SizeNESW, SizeNS, SizeNWSE, SizeWE, UpArrow, Wait, Unknown.

Size-유형의 커서에 사용된 약자는 방위를 나타냅니다. 예, NESW = NorthEast+SouthWest. 손-모양의 커서는 (찍기와 잡기)는 Unknown으로 분류되어 있습니다.

현재 캐럿(텍스트 삽입 위치)의 X와 Y 좌표입니다. 이 좌표는 활성 창에 상대적입니다. CoordMode를 사용하여 전체 화면에 대하여 상대적으로 만들지 않는 한 말입니다. 활성 창이 없거나 캐럿 위치를 결정할 수 없으면, 이 변수는 비어 있습니다.

다음 스크립트로 캐럿을 이동시켜서 그의 현재 위치가 자동-갱신 툴팁에 나타나는 것을 볼 수 있습니다. 어떤 창은 (예, MS Word) 실제 위치에 상관 없이 같은 캐럿 위치를 보고합니다.

#Persistent
SetTimer, WatchCaret, 100
return
WatchCaret:
  ToolTip, X%A_CaretX% Y%A_CaretY%, A_CaretX, A_CaretY - 20
return