create-native-map - 클라우드 온라인

프로그램:

이름

create-native-map - C/C# 매핑 작성기

개요

네이티브 맵 만들기 [옵션]* 어셈블리-파일-이름 출력-접두사

옵션

--autoconf-헤더=헤더
머리글 일반적으로 C와 함께 사용되는 구문의 헤더 파일 이름입니다. #포함
진술, 예 #포함 or #포함 "local.h" .

포함 이름에서 Autoconf 형식의 매크로가 생성되고 #포함
지시문은 #ifdef 내 Autoconf 매크로에 대한 블록
생성 .c 파일.

예를 들어, --autoconf-헤더= 코드를 생성합니다.

#ifndef HAVE_STDIO_H
#포함하다
#endif /* ndef HAVE_STDIO_H */

--autoconf-구성원=구성원
에 대한 모든 액세스를 지정합니다. 회원 안에 싸야합니다 #ifdef HAVE_MEMBER
블록. 회원 다음 중 하나일 수 있습니다. 분야 명 또는 클래스 이름 . 분야 명
콤비네이션.

예를 들어 C# 선언이 주어진 경우:

[Mono.Unix.Native.Map ("struct dirent")]
구조체 디렌트 {
공개 긴 d_off;
}

그때 --autoconf-구성원=d_off 다음과 유사한 코드를 생성합니다.

INT
ToDirent(struct dirent *from, struct Dirent *to)
{
#ifdef HAVE_STRUCT_DIRENT_D_OFF
to->d_off = from->d_off;
#endif /* ndef HAVE_STRUCT_DIRENT_D_OFF */
}

--제외-네이티브-심볼=SYMBOL
SYMBOL 하는 [Dll가져오기] -표시해야 하는 메소드 지원 프로토타입을 생성하다
그것을 위해.

--impl-헤더=헤더
삽입 #포함 생성된 문 .c ~을위한 파일 머리글 .

예를 들어, --impl-헤더= 생성

#포함

--impl-macro=매크로
삽입 #밝히다 생성된 문 .c 파일. MACRO 포함 할 수 있습니다 = 에
매크로 이름과 매크로 값을 구분하십시오.

예를 들어, --impl-매크로=FOO=42 생성

#FOO 42 정의

--라이브러리=라이브러리
프로토타입 만들기 [Dll가져오기] -네이티브를 참조하는 표시된 메서드
도서관 도서관 생성된 .h 파일.

--공개 헤더=헤더
삽입 #포함 생성된 문 .h ~을위한 파일 머리글 .

예를 들어, --공개 헤더= 생성

#포함

--공공-매크로=매크로
삽입 #밝히다 생성된 문 .h 파일. MACRO 포함 할 수 있습니다 = 에
매크로 이름과 매크로 값을 구분하십시오.

예를 들어, --공공-매크로=FOO=42 생성

#FOO 42 정의

--이름 바꾸기-멤버=FROM=TO
이것은 다음과 같은 경우에 사용됩니다. FROM C 매크로이므로 사용하려면 변경해야 합니다.
제정신으로. 관리 표현에 대해 생성된 모든 참조는 다음을 사용합니다. ~까지 를 받아야 하는 미국 여행자
of FROM .

예를 들어 C# 선언이 주어진 경우:

[Mono.Unix.Native.Map ("구조 통계")]
구조체 통계 {
공개 긴 st_atime;
}

그리고 인수 --rename-member=st_atime=st_atime_ , 생성된 .h 파일은
있다:

구조체 통계 {
gint64 st_atime_;
};

(변경된 필드 이름 참고) 생성되는 동안 .c 파일에는 다음이 포함됩니다.

ToStat(구조 통계 *from, 구조 통계 *to)
{
to->st_atime_ = from->st_atime;
}

--이름 바꾸기-네임스페이스=FROM=TO
기본적으로 C "네임스페이스"(기호 접두사)는 C# 네임스페이스입니다. 내의 유형
C# 네임스페이스 모노.유닉스.네이티브 C "네임스페이스"에 있을 것입니다. Mono_Unix_Native . 사용
--이름 바꾸기-네임스페이스 예를 들어 기본값을 수정하려면 --이름 바꾸기-
네임스페이스=Mono.Unix.Native=Mono_Posix .

기술

네이티브 맵 만들기 특정 시나리오를 위한 프로그램입니다.
C# 유형을 기반으로 서로 동기화된 C와 C# 간에 결합됩니다.

Platform Invoke는 관리 코드가 모든 플랫폼의 정확한 유형과 레이아웃을 알고 있는 경우에만 유용합니다.
사용하는 관리되지 않는 구조. 이것은 일반적으로 Windows의 경우이지만 지원 경우
유닉스에서. 예를 들어, 구조체 스탯 다양한 크기의 유형을 사용합니다.
플랫폼에서 플랫폼으로(또는 정의된 컴파일러 매크로를 기반으로!). 예를 들어, off_t
일반적으로 ILP32 플랫폼에서는 부호 있는 32비트 정수이지만 부호 있는 64비트 정수일 수도 있습니다.
LP64 플랫폼에서는 이지만 ILP64 플랫폼에서는 32비트 부호 있는 정수일 수도 있습니다.
_FILE_OFFSET_BITS 매크로의 값은 64입니다. 요컨대 모든 것이 Unix 내에서 유연합니다.
관리 코드는 이러한 유연성을 처리할 수 없습니다.

따라서 틈새 시장 네이티브 맵 만들기 : 관리 코드가 타겟팅할 수 있는 고정 ABI를 가정합니다.
관리되는 표현을 해당 네이티브에 "썽크"하는 코드를 생성합니다.
표현. 이 작업을 수행해야 합니다. 모두 플랫폼마다 다를 수 있으며
열거형 값( 시그버스 FreeBSD에서는 값이 10이지만 FreeBSD에서는 7입니다.
Linux) 구성원을 구조화하기 위해(얼마나 큰 off_t ?).

네이티브 맵 만들기 검사 할 것이다 어셈블리-파일-이름 다음 파일을 출력합니다.

출력 접두사.h
열거형 값, 클래스 및 구조체 선언, 위임을 포함합니다.
선언 및 [Dll가져오기] -표시된 메서드(다음에 의해 지정된 라이브러리에서
--도서관 ) 어셈블리 내 어셈블리-파일-이름 .

출력접두사.c
열거 및 구조 변환의 구현을 포함합니다.
기능.

출력 접두사.cs
부분 클래스 포함 NativeConvert 포함하는 열거 번역
방법.

출력 접두사.xml
열거 변환을 위한 ECMA XML 문서 스텁을 생성합니다.
방법 출력 접두사.cs .

네이티브 맵 만들기 주로 찾는다 지도 속성 -장식된 유형이며 두 가지를 사용합니다.
지도 속성 속성 :

네이티브 유형
해당 C 유형을 포함합니다. 클래스에 적용되는 경우에만 유용합니다.
구조 및 필드.

억제플래그
의 열거형 멤버에 지정된 경우 [플래그] -장식된 열거
유형, 해제 비트 마스킹 열거를 위한 일반 코드 생성기 지원
유형.

이는 비트마스크 및 비트마스크가 아닌 정보가
동일한 유형이며 비트마스크 검사는 비트마스크가 아닌 항목에 사용하면 안 됩니다.
가치. 예: Mono.Unix.Native.FilePermissions.S_IFREG , 이는
비트마스크 값, 반면 대부분의 파일권한 비트마스크 값(
파일권한.S_IRUSR , 파일권한.S_IWUSR 등).

XNUMXD덴탈의 지도 속성 특성은 클래스, 구조체, 대리자, 필드 및
열거.

대표자들
대리자를 위한 코드 생성은 다음을 무시합니다. MapAttribute.NativeType 재산 및
함수 포인터를 생성 형식 정의 대리자 선언과 가장 일치하는
로 .h 파일.

예를 들어,

네임스페이스 Foo {
[지도]
위임 문자열 MyCallback(문자열 s);
}

생성 형식 정의 :

typedef char* (*Foo_MyCallback) (const char *s);

클래스 및 구조
A [지도] -장식된 클래스 또는 구조는 C 구조 선언을 가져옵니다.
.h 파일 :

[지도]
구조체 푸 {
공공 정수 i;
}

된다

구조체 푸 {
공공 정수 i;
};

경우 MapAttribute.NativeType 속성이 설정되면 변환 함수가
이내에 선언 .h 파일 내에서 생성 .c 파일 :

네임스페이스 Foo {
[지도("구조 통계")]
구조체 통계 {
공개 단위 st_uid;
}
}

된다

/* .h 파일 */
구조체 Foo_Stat {
부호 없는 int st_uid;
};
INT
Foo_FromStat(struct Foo_Stat *from, struct stat *to);
INT
Foo_ToStat(struct stat *to, sxtruct Foo_Stat *to);

/* .c 파일 */
INT
Foo_FromStat(struct Foo_Stat *from, 구조체 stat *to)
{
memset(to, 0, sizeof(*to);
to->st_uid = from->st_uid;
0가 돌아;
}

INT
Foo_ToStat(struct stat *to, sxtruct Foo_Stat *to)
{
memset(to, 0, sizeof(*to);
to->st_uid = from->st_uid;
0가 돌아;
}

클래스의 경우 변환 함수는 클래스에서 선언된 필드만 복사합니다.
그 자체. 부모 클래스에서 선언된 필드는 복사되지 않습니다. (이 때문입니다
네이티브 맵 만들기 상속이 C에서 구현되는 방법을 모릅니다. 따라서
상위 클래스에서 필드를 복사하는 것은 변환 호출자에게 맡겨집니다.
기능.)

필드 필드(1)에 지도 속성 속성이고 (2)는
MapAttribute.NativeType 속성이 설정되면 지정된 기본 유형이 사용됩니다.
오버플로 검사를 위해. 예를 들어:

네임스페이스 Foo {
[지도("구조 통계")]
구조체 통계 {
[Map ("off_t")] public long st_size;
}
}

생성

/* .h 파일 */
구조체 Foo_Stat {
gint64 st_size;
};
INT
Foo_FromStat(struct Foo_Stat *from, struct stat *to);
INT
Foo_ToStat(struct stat *to, sxtruct Foo_Stat *to);

/* .c 파일 */
INT
Foo_FromStat(struct Foo_Stat *from, 구조체 stat *to)
{
_cnm_return_val_if_overflow(off_t, from->st_size, -1);

memset(to, 0, sizeof(*to);
to->st_size = from->st_size;
0가 돌아;
}

INT
Foo_ToStat(struct stat *to, sxtruct Foo_Stat *to)
{
_cnm_return_val_if_overflow(gint64, from->st_size, -1);

memset(to, 0, sizeof(*to);
to->st_size = from->st_size;
0가 돌아;
}

이것은 변환 기능 내에서 더 나은 오류 검사에 유용합니다.
MapAttribute.NativeType 무엇을 알 수 있는 다른 방법이 없기 때문에 이를 위해 필요합니다.
기본 유형은 (시스템 헤더 파일을 구문 분석하지 않고...)입니다.

열거
C 열거형과 각 멤버에 대한 매크로를 생성합니다.
열거. 에 및 ~ 함수는 또한 .h 파일 및
에서 구현 .c 파일.

예를 들어,

네임스페이스 Foo {
[지도]
열거형 Errno {
에인발
}
}

에서 다음을 생성합니다. .h 파일 :

열거형 Foo_Errno {
Foo_Errno_EINVAL = 0,
#define Foo_Errno_EINVAL Foo_Errno_EINVAL
};
int Foo_FromErrno(int from, int *to);
int Foo_ToErrno(int from, int *to);

에서 다음을 생성합니다. .c 파일 :

INT
Foo_FromErrno(int from, int *to)
{
*에 = 0;
if (== Foo_Errno_EPERM에서)
#ifdef EINVAL
{*에 = EINVAL;}
#그밖에
{errno = EINVAL; -1 반환;}
#endif
0가 돌아;
}

INT
Foo_ToErrno(int from, int *to)
{
*에 = 0;
#ifdef EINVAL
if (== EINVAL에서)
{*to = Foo_Errno_EPERM; 0 반환;}
#endif
반환 -1;
}

관리되는 열거형이 [플래그] -훌륭하게 꾸민
열거형(비트 플래그를 설명하기 위해)이지만 이것이 기본 아이디어입니다.

메일링 기울기

방문 http://lists.ximian.com/mailman/listinfo/mono-devel-list 자세한 내용은.

WEB 대지

방문 http://www.mono-project.com 자세한 내용은

네이티브 맵 만들기(1)

onworks.net 서비스를 사용하여 온라인에서 create-native-map 사용