전환(Diversion;명사)은 출력을 임시로 저장하는 방법의 하나이다.
m4의 출력은 언제든지 임시 파일로 전환(divert;동사)될 수 있다. 그리고
이것을 나중에 출력 스트림(stream; 흐름)으로 다시 끼워 넣을 수 있다. (이것을
undivert 시킨다라고 함) (역자주: 원문에는 undivert의 수동태인
undiverted라고 되어 있던 것을 undivert 시킨다라고 번역하였음.
이후의 본문에서는 주로 `되돌리다'라고 번역함.)
전환에 붙이는 번호는 0에서부터 시작하여 큰 값 쪽으로 헤아린다. 전환 번호 0은
보통의 출력 스트림이다. 동시에 존재하는 전환들의 갯수는 주로 그것을
표현하는 데 사용되는 메모리에 의해 제한된다. 왜냐하면 GNU m4는 전환을
메모리에 넣어 두려고 하기 때문이다. 그러나 전환들 모두가 함께 사용할 수 있는
총 메모리 양에는 제한이 있다(현재는 512K). 최대값을 넘어 가려고 할 때 쯤에는
임시 파일이 열려서 현재 메모리에 아직 있는 전환들 중 가장 큰 것을 받고, 다른
전환이 쓰도록 이 메모리를 해제한다. 그래서 이론 상으로 전환의 갯수는 사용
가능한 파일 기술자의 갯수에 의해 제한이 된다.
divert(opt number)
여기에서 number는 전환하는 데 사용되는 번호이다. 만일 number가 없다면 0으로 가정된다.
divert는 확장되지 않는다.
m4의 모든 입력의 처리가 끝날 때, 그 때까지 존재하는 모든 전환들은
자동적으로 번호 순서대로 undivert된다.
(역자주: undivert의 뜻은 see section 출력을 전환하기, 원래대로 놓기)
divert(1) This text is diverted. divert => This text is not diverted. =>This text is not diverted. ^D => =>This text is diverted.
같은 인자를 가지는 여러 번의 divert의 호출은 이전에 전환된
텍스트를 덮어 써 버리지 않는다. 단지 그 뒤에 덧붙일 뿐이다.
만일 출력이 존재하지 않는 전환으로 전환된 다면 그것은 단순히 사라져 버린다. 이것은 원치 않는 출력을 없애 버리는 데 사용될 수 있다. 원치 않는 출력의 흔한 경우는 매크로 정의 때에 뒤에 따라붙는 줄바꿈 문자일 것이다. 다음에 그것을 피하는 방법을 소개한다.
divert(-1) define(`foo', `Macro `foo'.') define(`bar', `Macro `bar'.') divert =>
이것은 m4에서 흔한 프로그래밍 관습이다.
전환된 텍스트는 내장 매크로 undivert를 사용하여 원래대로 돌려 놓을
수 있다.
undivert(opt number, ...)
이것은 인자로 주어진 전환들을 인자로 주어진 순서대로 원래대로 돌려 놓게 된다. 인자가 없을 경우는 모든 전환들이 번호 순서대로 되돌려진다.
undivert의 확장은 없다.
divert(1) This text is diverted. divert => This text is not diverted. =>This text is not diverted. undivert(1) => =>This text is diverted. =>
마지막 두 개의 빈 줄에 주의하라. 그 중 하나는 undivert를 뒤따라서 나온
것이고 다른 것은 divert를 뒤따라서 나타난 것이다!
전환은 종종 이와 같이 빈 줄로 시작된다.
전환된 텍스트가 되돌려 질 때에는, 그것은 m4가 다시 읽지는
않는다. 단지 현재의 출력으로 복사만을 할 뿐이다. 그러므로 다른 전환으로
되돌리는 것(역자주: 원문은 to undivert into a diversion 임)은 에러가 아니다.
전환이 되돌려 진 후에는, 그 전환된 텍스트는 사라져 버리며, 전환된 텍스트를 여러 번 되돌리는 것은 불가능하다.
divert(1) This text is diverted first. divert(0)undivert(1)dnl => =>This text is diverted first. undivert(1) => divert(1) This text is also diverted but not appended. divert(0)undivert(1)dnl => =>This text is also diverted but not appended.
현재의 전환을 다시 되돌리려는 시도는 조용히 무시된다. (역자주: 이것은 어떤 전환에서 자신을 자신에게 되돌리는 것을 말하는 것 같음.)
GNU m4는 이름을 지정한 파일을 되돌릴 수 있다. 인자로 숫자가 아닌 파일
이름을 주면, 현재의 출력으로 복사되며, 해석되지 않는다. 이것을 보조하는 것이
앞에서 이야기한 내장 매크로 include이다. (see section 파일을 삽입하기) 이
차이점을 설명하기 위해서, 파일 `foo'가 단어 `bar'를 포함하고
있다고 가정하자.
define(`bar', `BAR') => undivert(`foo') =>bar => include(`foo') =>BAR =>
divnum
이것은 현재의 전환 번호로 확장된다.
Initial divnum =>Initial 0 divert(1) Diversion one: divnum divert(2) Diversion two: divnum divert => ^D => =>Diversion one: 1 => =>Diversion two: 2
인자가 없는 마지막 divert 호출이 꼭 필요하다. 이렇게 하지 않으면
전환에서부터 되돌려지게 되는(undiverted) 텍스트가 그 자신으로 전환될 것이기
때문이다.
출력을 전환하는 당시에는 전환시킨 텍스트가 정말로 필요하게 될지 필요 없게
될지를 알 수 없는 경우가 많다. 비어 있지 않은 모든 전환들은 입력의 끝 단계에서
메인 출력 스트림으로 되돌려 들어 가기 때문에, 전환을 버릴 방법이 필요하다.
모든 전환들을 버리고 싶다면, 가장 쉬운 것은 다음에 나오는 것처럼,
m4로의 입력의 마지막에 `divert(-1)'을 한 다음 명시적으로
`undivert'를 하는 것이다.
divert(1) Diversion one: divnum divert(2) Diversion two: divnum divert(-1) undivert ^D
아무런 출력도 생성되지 않을 것이다.
해당하는 전환만을 선택하여 지우는 것은 다음의 매크로를 사용하면 가능하다.
define(`cleardivert', `pushdef(`_num', divnum)divert(-1)undivert($@)divert(_num)popdef(`_num')') =>
이것은 단지 undivert처럼 호출되지만, 그 효과는 인자로 주어진 전환을
지우는 것이다. (이 매크로에는 다루기 어려운 버그가 하나 있다! 그것을
여러분이 찾아서 고칠 수 있는지 시도해 보기 바란다.)
Go to the first, previous, next, last section, table of contents.