Location::Location (4)
Location 생성자입니다.
Location ( );
설명
이 기본 생성자는 현재 머신의 로컬 루트를 참조하기 위해 주어진 인스턴스를 초기화합니다.
이 생성자는 항상 성공할 것입니다.
InputOutput 모듈은 이미 public 기본 Location 인스턴스(IO::localRoot)를 포함하고 있습니다.
그것은 선언된 상수입니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성할 수 있습니다!
다음 버전부터 이용 가능합니다: 1.0
explicit Location (
const char* targetPath
);
파라미터
- targetPath
-
원하는 대상을 참조하는 파일 시스템 주소(경로)의 (C 문자열의) 텍스트 표현입니다.
현재 플랫폼의 텍스트 표현 또는 URL 표현이 될 수 있습니다. URL 표현은 다음과 같은 구문으로 존재하지 않는 "lan:" 프로토콜(LAN = Local Area Network)을 사용합니다:"lan://" networkAddress "/" localAddress
networkAddress = (networkName ("." networkName)*)? | "localhost"
localAddress = (localName ("/" localName)*)?
'*'는 0 이상, '?'는 0 또는 1 (선택사항) 그리고 '|'는 OR를 의미합니다. networkName은 '.'를 제외한 나머지 문자를 포함할 수 있지만, localName은 '/'를 제외한 나머지 문자를 포함할 수 있습니다.
URL 네트워크 주소(호스트)는 역순으로 표시됩니다. 즉, 왼쪽에서 1번째 파트가 최하위 순서 이름입니다. (반대로 로컬 주소는 "일반" 순서로 표시됩니다. 즉, 왼쪽에서 1번째 파트가 최상위 순서 이름입니다)
예제: "lan://Server.Subnetwork/Share/Folder/File.ext".
설명
이 생성자는 targetPath로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없습니다. 만약 targetPath가 구문적으로 불법이거나 (메모리가 고갈되었으면), Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
explicit Location (
const GS::UniString& targetPath
);
파라미터
- targetPath
- 원하는 대상을 참조하는 파일 시스템 주소(경로)의 (Unicode UTF-16 문자열 형태의) 텍스트 표현입니다.
설명
이 생성자는 targetPath로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없습니다. 만약 targetPath가 구문적으로 불법이거나 (메모리가 고갈되었으면), Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
explicit Location (
const FSSpec& targetSpec
);
파라미터
- targetSpec
- 원하는 대상을 참조하는 파일 시스템 주소의 네이티브 Macintosh 표현입니다.
설명
이 생성자는 targetSpec으로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없지만, targetSpec으로 지정한 볼륨은 반드시 마운트되어 있어야 합니다. 이 생성자는 당연히 플랫폼 종속적입니다. 만약 몇 가지 이유로 (또는 메모리가 고갈되어) targetSpec이 불법이면, Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
explicit Location (
const FSRef& targetRef
);
파라미터
- targetRef
- 원하는 대상을 참조하는 파일 시스템 주소의 네이티브 Macintosh 표현입니다.
설명
이 생성자는 targetRef로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 이 메소드는 기존 엔트리들에 대해서만 사용합니다. 이 생성자는 당연히 플랫폼 종속적입니다. 만약 몇 가지 이유로 (또는 메모리가 고갈되어) targetRef가 불법이면, Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
explicit Location (
const CFURLRef& targetRef
);
파라미터
- targetRef
- 원하는 대상의 네이티브 Macintosh URL 표현입니다.
설명
이 생성자는 targetRef로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 유효한 CFURL 표현이 없는 위치들이 있다는 것을 참고하십시오. (예. 로컬 루트는 Macintosh 상에서 가상입니다) 그러한 위치들에 대해서는 오류를 리턴합니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
Location (
const Location& parent,
const Name& name
);
파라미터
- parent
- 새로운 Location 인스턴스의 베이스 주소입니다.
- name
- 새로운 Location 인스턴스의 마지막 이름입니다.
설명
이 생성자는 parent의 내용에 name을 이어붙여서 얻은 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없습니다. 만약 메모리가 고갈되면, Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성할 수 있습니다!
다음 버전부터 이용 가능합니다: 1.0
Location (
POSIXPathSelector selector,
const char* path
);
파라미터
- selector
- 이것은 표준 UNIX 표현을 결정하는 열거형입니다. 값은 하나만 있습니다: IO::Location:POSIXPath.
- path
- 원하는 대상을 참조하는 파일 시스템 주소(경로)의 (C 문자열 형태의) 텍스트 표현입니다.
설명
이 생성자는 표준 UNIX 표현 형태의 path로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없습니다. 만약 path가 구문적으로 불법이면 (또는 메모리가 고갈되면), Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
다음 버전부터 이용 가능합니다: 1.0
Location (
POSIXPathSelector selector,
const GS::UniString& path
);
파라미터
- selector
- 이것은 표준 UNIX 표현을 결정하는 열거형입니다. 값은 하나만 있습니다: IO::Location:POSIXPath.
- name
- 원하는 대상을 참조하는 파일 시스템 주소(경로)의 (Unicode UTF-16 문자열 형태의) 텍스트 표현입니다.
설명
이 생성자는 표준 UNIX 표현 형태의 path로 지정한 대상을 참조하기 위해 주어진 인스턴스를 초기화합니다. 대상은 반드시 존재할 필요는 없습니다. 만약 path가 구문적으로 불법이면 (또는 메모리가 고갈되면), Location 인스턴스의 상태는 유효하지 않게 됩니다.
생성 결과는 차후 GetStatus 메소드의 호출로 검사할 수 있습니다. 리턴 값 NoError는 성공적인 생성을 의미합니다.
모듈 초기화 전에 이 생성자로 인스턴스들을 생성해서는 안 됩니다!
