Initial Commit.

2026-06-23 21:47:51 +08:00
commit d17f68e979
5201 changed files with 318318 additions and 0 deletions
@@ -0,0 +1,45 @@
+# StringBufferLen
+
+The function returns the size of buffer allocated for the string.
+
+```
+int  StringBufferLen(
+   string  string_var      // string
+   )
+
+```
+
+Parameters
+
+string_var
+
+[in]  String.
+
+Return Value
+
+The value 0 means that the string is constant and buffer size can't be changed. -1 means that the string belongs to the client terminal, and modification of the buffer contents can have indeterminate results.
+
+Example:
+
+```
+void OnStart()
+  {
+   long length=1000;
+   string a="a",b="b";
+//---
+   long i;
+   Print("before: StringBufferLen(a) = ",StringBufferLen(a),
+         "  StringLen(a) = ",StringLen(a));
+   for(i=0;i<length;i++)
+     {
+      StringAdd(a,b);
+     }
+   Print("after: StringBufferLen(a) = ",StringBufferLen(a),
+         "  StringLen(a) = ",StringLen(a));
+  }
+
+```
+
+See also
+
+[StringAdd](/en/docs/strings/stringadd), [StringInit](/en/docs/strings/stringinit), [StringLen](/en/docs/strings/stringlen), [StringFill](/en/docs/strings/stringfill)