通过 PAnsiChar (char *) 传递 AnsiString 是否明确需要空终止符？

Question

这里是新来的，并且是互操作和 C(++) 我确实搜索了这个问题的答案，但在 SO 或 www 上找不到它。这是我没有选择正确的单词来搜索答案，或者我错过了这个非常基本的问题的重点......

使用 Delphi dll 和“C(++) dll caller”之间的互操作，您是否明确声明 Delphi dll 中的空终止符以传递回 dll 调用者？

例如DLL调用者（C代码）

char ErrorMessage[10];
(*GetMessageFromDLLFunction)(&ErrorMessage[0], 10); // (char * ErrorMessage, int buffSize)

Dll 代码（Delphi）：

GetMessageFromDLLFunction(errorMessage: PAnsiChar; buffSize: Integer)

// What if the message generated in this function exceeds 10 characters?
// do I return 9 characters and a null terminator?
tmpMessage := SetLength(tmpMessage, buffSize-1);
tmpMessage := tmpMessage + #0;
System.AnsiStrings.StrCopy(errorMessage,PAnsiChar(tmpMessage));

// or do I return 9 characters without an explicit null terminator?
tmpMessage := SetLength(tmpMessage, buffSize-1);
System.AnsiStrings.StrCopy(errorMessage,PAnsiChar(tmpMessage));

什么是最佳/正确做法？

Answer 1

如果您返回的字符串有时以 null 结尾，有时则不是，那么您给调用者带来了沉重的复杂性负担。调用者有时必须添加空终止符。并且调用者面临着将字符串放在一个太短而不能包含空终止符的缓冲区中的尴尬情况。通常最好将复杂性降低到尽可能低的水平，所以我的感觉是，在所有条件相同的情况下，您应该始终返回一个以空值结尾的缓冲区。

您的代码目前没有尝试通知用户需要多大的缓冲区来存储完整的字符串。您可以继续这种方式，但我绝对建议您确保返回的值始终以空值结尾。看起来像这样：

function GetString(Buffer: PAnsiChar; Len: Integer): Integer;
var
  Value: AnsiString;
begin
  if Len < 1 then
  begin
    Result := STATUS_INVALID_PARAMETER;
    exit;
  end;

  Value := ... // get the string to be returned somehow
  StrLCopy(Buffer, PAnsiChar(Value), Len - 1);
  if Length(Value) < Len then
    Result := STATUS_OK
  else
    Result := STATUS_BUFFER_TOO_SHORT;
end;

或者，您可以修改接口，让调用者知道需要多大的缓冲区。可能看起来像这样：

function GetString(Buffer: PAnsiChar; var Len: Integer): Integer;
var
  Value: AnsiString;
begin
  if Len < 0 then
  begin
    Result := STATUS_INVALID_PARAMETER;
    exit;
  end;

  Value := ... // get the string to be returned somehow
  if Len > 0 then
    StrLCopy(Buffer, PAnsiChar(Value), Len - 1);
  if Length(Value) < Len then
    Result := STATUS_OK
  else
    Result := STATUS_BUFFER_TOO_SHORT;
  Len := Length(Value) + 1;
end;

Answer 2

这完全由您决定。由于您将缓冲区长度作为输入传递，因此您可以采用任何一种方式。但是，如果您选择在输出中省略 null，您应该让函数返回实际写入缓冲区的字符数，以便调用者知道在哪里停止读取。如果完整的消息很重要，您甚至可以返回错误来让调用者知道缓冲区太小而无法接收完整的输出。