_xtool: llpyg

py/unicode.go

@@ -0,0 +1,47 @@
+/*
+ * Copyright (c) 2024 The GoPlus Authors (goplus.org). All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package py
+
+import (
+	_ "unsafe"
+
+	"github.com/goplus/llgo/c"
+)
+
+// https://docs.python.org/3/c-api/unicode.html
+
+// Return a pointer to the UTF-8 encoding of the Unicode object, and store the
+// size of the encoded representation (in bytes) in size. The size argument can
+// be nil; in this case no size will be stored. The returned buffer always has
+// an extra null byte appended (not included in size), regardless of whether
+// there are any other null code points.
+//
+// In the case of an error, nil is returned with an exception set and no size is
+// stored.
+//
+// This caches the UTF-8 representation of the string in the Unicode object, and
+// subsequent calls will return a pointer to the same buffer. The caller is not
+// responsible for deallocating the buffer. The buffer is deallocated and pointers
+// to it become invalid when the Unicode object is garbage collected.
+//
+// llgo:link (*Object).CStrAndLen C.PyUnicode_AsUTF8AndSize
+func (o *Object) CStrAndLen() (*c.Char, uintptr) { return nil, 0 }
+
+// As CStrAndLen, but does not store the len.
+//
+// llgo:link (*Object).CStr C.PyUnicode_AsUTF8
+func (o *Object) CStr() *c.Char { return nil }