고정 크기 버퍼(C# 프로그래밍 가이드)

아티클
08/09/2011

C#에서 fixed 문을 사용하여 데이터 구조에 배열 크기가 고정된 버퍼를 만들 수 있습니다. 고정 크기의 배열은 다른 언어로 작성된 코드와 같은 기존 코드, 기존 DLL 또는 COM 프로젝트를 사용하여 작업할 때 유용합니다. 고정 배열에는 일반 구조체 멤버에 허용되는 특성이나 한정자를 모두 사용할 수 있습니다. 유일한 제한 사항은 배열 형식이 bool, byte, char, short, int, long, sbyte, ushort, uint, ulong, float 또는 double이어야 한다는 점입니다.

private fixed char name[30];

설명

이전 버전의 C#에서는 C++ 스타일의 고정 크기 구조를 선언하기가 어려웠습니다. 배열을 포함하는 C# 구조체에 배열 요소가 포함되지 않기 때문입니다. 대신, 구조체는 요소에 대한 참조를 포함합니다.

C# 2.0에는 unsafe 코드 블록에 사용되는 구조체에 고정 크기 배열을 포함할 수 있는 기능이 추가되었습니다.

예를 들어, C# 2.0 이전에는 다음 struct는 8 바이트 크기가 됩니다. pathName 배열은 힙에 할당된 배열 참조입니다.

    public struct MyArray
    {
        public char[] pathName;
        private int reserved;
    }

C# 2.0부터 struct에 포함된 배열을 포함할 수 있습니다. 다음 예제에서는 fixedBuffer 배열의 크기가 고정되어 있습니다. 배열의 요소에 액세스하려면 fixed 문을 사용하여 첫 번째 요소에 대한 포인터를 설정합니다. fixed 문은 fixedBuffer의 인스턴스를 메모리의 특정 위치에 고정합니다.

namespace FixedSizeBuffers
{
    internal unsafe struct MyBuffer
    {
        public fixed char fixedBuffer[128];
    }

    internal unsafe class MyClass
    {
        public MyBuffer myBuffer = default(MyBuffer);
    }

    internal class Program
    {
        static void Main()
        {
            MyClass myC = new MyClass();

            unsafe
            {
                // Pin the buffer to a fixed location in memory.
                fixed (char* charPtr = myC.myBuffer.fixedBuffer)
                {
                    *charPtr = 'A';
                }
            }
        }
    }
}

128 요소 char 배열의 크기는 256바이트입니다. 고정 크기 char 버퍼에는 인코딩과 상관없이 문자 당 항상 2바이트가 사용됩니다. 이는 CharSet = CharSet.Auto 또는 CharSet = CharSet.Ansi를 사용하여 char 버퍼를 API 메서드나 구조체로 마샬링하는 경우에도 마찬가지입니다. 자세한 내용은 CharSet을 참조하십시오.

다른 일반적인 고정 크기 배열로는 bool 배열이 있습니다. bool 배열의 요소 크기는 항상 한 바이트입니다. bool 배열은 비트 배열이나 버퍼를 만들기에 적절하지 않습니다.

참고

stackalloc을 사용하여 만든 메모리를 제외하고 C# 컴파일러와 CLR(공용 언어 런타임)에서는 어떠한 보안 버퍼 오버런 검사도 수행하지 않습니다. 따라서 안전하지 않은 코드와 마찬가지로 항상 주의해야 합니다.

안전하지 않은 버퍼는 다음과 같은 점에서 일반 배열과 다릅니다.