Factor Language: Conventions

Various conventions are used throughout the Factor documentation and source code.

다양한 관례들이 사용된다 통해서 만나는 것은 Factor 문서와 소스코드.

Glossary of terms

용어사전

Common terminology and abbreviations used throughout Factor and its documentation:

일반적 용어법과 축약어들 사용되는 통해서 만나는 것은 Factor와 그것의 문서:

Term 용어	Definition 정의
alist	an association list; see Association lists 관계 리스트
assoc	an associative mapping; see Associative mapping operations 관계적 사상
associative	mapping  an object whose class implements the Associative mapping protocol 어떤 객체 그것의 클래스가 구현한다 관계적 사상 프로토콜
boolean	t or f 참 또는 거짓
class	a set of objects identified by a class word together with a discriminating predicate. See Classes 어떤 집합 관련된 것은 객체들 확인되다 그 힘의 원천은 한 클래스 워드 그것과 함께하는 것은 차별화된 술어.
combinator	a word taking a quotation or another word as input; a higher-order function. See Combinators 어떤 워드가 취하고 있는 것은 인용 또는 다른 워드 취하는 방식은 입력; 고차함수.
definition	specifier  an instance of definition which implements the Definition protocol 어떤 인스턴스 관련된 것은 정의 그것은 구현한다 "정의 프로토콜"
generalized boolean	an object interpreted as a boolean; 어떤 객체 번영된다 그 자격은 불리언 a value of f denotes false and anything else denotes true 한 값 관련된 걱은 f 의미한다 거짓 그리고 그 밖의 것은 의미한다 참.
generic word	a word whose behavior depends can be specialized on the class of one of its inputs. See Generic words and methods. 어떤 워드 그것의 행동은 의존한다 할 수 있다 특정지어지다 접한 것은 클래스 관련된 것은 하나  관련된 것은 그것의 입력들.
method	a specialized behavior of a generic word on a class. See Generic words and methods 어떤 특화된 행위 관련된 것은 어떤 일반적 워드 접한 것은 어떤 클래스.
object	any datum which can be identified 무엇이든 데이터들 그것들은 할 수 있다 확인된다
ordering specifier	see Ordering specifiers
pathname string	an OS-specific pathname which identifies a file 어떤 OS 특화된 경로명 그것은 확인한다 어떤 파일
quotation	an anonymous function; an instance of the quotation class.  어떤 무기명 함수; 어떤 인스턴스 관련된 것은 인용 클래스. More generally, instances of the callable class can be used in many places documented to expect quotations 좀 더 일반적으로, 인스턴스들 관련된 것은 호출 가능한 클래스 할 수 있다 사용되다 포함하는 것은   많은 곳들에서 문서화된 나아가서 기대하다 인용을.
sequence	a sequence; see Sequence protocol
slot	a component of an object which can store a value 어떤 콤포넌트 관련된 것은 어떤 객체 그것은 할 수 있다 저장한다 어떤 값
stack effect	a pictorial representation of a word's inputs and outputs, for example + ( x y -- z ). See Stack effect declarations 어떤 그림상의 표현 관련된 것은 어떤 워드의 입력들과 출력들, 예를들면 + ( x y -- z).
true value	any object not equal to f 임의의 객체 아닌것 같음 나아가서 만나는 것은 f
vocabulary or vocab	a named set of words. See Vocabularies 어떤 이름 붙여진 집합 관련된 것은 워드들
vocabulary specifier	a vocab, vocab-link or a string naming a vocabulary 어떤 vocab, vocab-link 또는 어떤 문자열 명명하는 것은 어휘(용어)
word	the basic unit of code, analogous to a function or procedure in other programming languages. See Words  기본 단위 관련된 것은 코드, 유사한 것은 나아가서 만나는 것이 함수 또는 프로시저 포함하는 것은 다른 프로그래밍 언어들.

Documentation conventions

문서화 관련들

Factor documentation consists of two distinct bodies of text.

Factor 문서는 구성한다 관련된 것은 2개의 독립적 몸체들 관련된 것은 텍스트.

There is a hierarchy of articles, much like this one, and there is word documentation.

존재한다 계층 관련된 것은 기사들, 많이 닮는다 이것, 그리고 존재한다 워드 문서.

Help articles reference word documentation, and vice versa, but not every documented word is 

도움말 기사들이 참고한다 워드 문서, 그리고 그 반대로, 그러나 아닌 모든 문서화된 워드가 참고된다

referenced from some help article.

출처는 어떤 도움말 기사.

The browser, completion popups and other tools use a common set of Definition icons.

브라우저, 완료 팝업들 그리고 다른 도구들이 사용한다 어떤 일반적인 집합 관련된 것은 정의 아이콘들.

Every article has links to parent articles at the top. Explore these if the article you are reading is too specific.

모든 기사가 갖고 있다 연결들 나아가서 만나는 것은 부모 기사들 지점은 그 꼭대기. 탐색하라 이것들을 만약 그 기사가 네가 읽고 있는 이다 너무 구체적이라면.

Some generic words have Description headings, and others have Contract headings.

어떤 generic words은 가진다 설명 머리글들, 그리고 다른것들은 가진다 약속 머리글들.

A distinction is made between words which are not intended to be extended with user-defined methods, and those that are.

어떤 유일함은 만들어진다 사이에서 워드들 그것들은 아니다 작정되어지지 나아가서 확장되도록 함께하는 것은 사용자 정의 메쏘드들과 그것들 그것들이 (워드들)이다.

Vocabulary naming conventions

어휘 명명 관례들

A vocabulary name ending in .private contains words which are either implementation details, unsafe, or both.

어떤 어휘는 (이름 끝나고 포함하는 것은 .private) 포함한다 워드들 그것들은 이다 중에 하나 구현 상세들, 비안전 또는  둘다.

For example, the sequence.private vocabulary contains words which access sequence elements without bounds checking (Unsafe sequence operations).

예를들면, sequence.private 어휘는 포함한다 워드들 그것들은 접근한다 sequence 요소들 함께하지 않는 것은 범위들 검사.

You should avoid using private words from the Factor library unless absolutely necessary.

너는 해야한다 피하다 사용하는 것은 private 워드들 출처는 Factor 라이브러리 드문 경우는 완전한 필요.

Similarly, your own code can place words in private vocabularies using <PRIVATE if you do not want other people using them without good reason.

비슷하게, 너의 소유하는 코드는 할 수 있다 위치하다 워드들 포함하는 것은 private 어휘들 사용하는 것은 <PRIVATE 만약 네가 하다 아니다 원하다라면 다른 사람을 그 사람들이 사용하는 것은 그것(너의 코드)들 함께하지 않는 것은 좋은 이유.

Word naming conventions

워드 명명 관례들

These conventions are not hard and fast, but are usually a good first step in understanding a word's behavior:

General form 일반적 형태	Description 설명	Examples 예제들
foo?	outputs a Boolean 출력들 불리언	empty?
foo!	a variant of foo which mutates one of its arguments 어떤 변종 관련된 것은 foo 그것은 변화한다 하나가 관련된 것은 그것의 아규먼트들.	append!
?foo	conditionally performs foo 조건적으로 수행한다 foo를	?nth
<foo>	creates a new foo 생성한다 하나의 새로운 foo를	<array>
>foo	converts the top of the stack into a foo 바꾼다 꼭대기 관련된 것은 스택 들어가서 나아가는 것은 foo	>array
foo>bar	converts a foo into a bar 바꾼다 foo를 들어가서 나아가는 것은 bar	number>string
new-foo	creates a new foo, taking some kind of parameter from the stack which determines the type of the object to be created 생성한다 새로운 foo, 취하면서 어떤 종류 관련된 것은 파라미터 출처는 스택 그것은 결정한다 형식 관련된 것은 객체들 나아가서 생성되는.	new-sequence, new-lexer, new
foo*	alternative form of foo, or a generic word called by foo 다른 형태 관련된 것은 foo, 또는 어떤 generic word 호출되는 힘의 원천은 foo	at*, pprint*
(foo)	implementation detail word used by foo. 구현 상세 워드 사용되는 힘의 원천은 foo	(clone)
set-foo	sets foo to a new value 지정한다 foo 나아가서 만는 것은 새로운 값.	set-length
foo>>	gets the foo slot of the tuple at the top of the stack; see Slot accessors 얻는다 foo slot 관련된 것은 tuple 만나는 지점은 꼭대기 관련된 것은 스택.	name>>
>>foo	sets the foo slot of the tuple at the top of the stack; see Slot accessors 지정한다 foo slot 관련된 것은 tuple 만나는 지점은 꼭대기 관련된 것은 스택.	>>name
with-foo	performs some kind of initialization and cleanup related to foo,  usually in a new dynamic scope 수행한다 어떤 종류 관련된 것은 초기화와 정리작업 관련된 것은 나아가서 만나는 것은 foo, 흔히 포함하는 것은 새로운 동적 스코프.	with-scope,                with-input-stream,                with-output-stream
$foo	help markup 도움말 마크업	$heading, $emphasis

Stack effect conventions

스택 효과 관례들

Stack effect conventions are documented in Stack effect declarations.

스택 효과 관례들은 문서화된다 포함하는 것은 Stack 효과 선언들.