[ruby-core:120229] [Ruby master Feature#20878] A new C API to create a String by adopting a pointer: `rb_enc_str_adopt(const char *ptr, long len, long capa, rb_encoding *enc)`
From:
"byroot (Jean Boussier) via ruby-core" <ruby-core@...>
Date:
2024-12-13 11:14:26 UTC
List:
ruby-core #120229
SXNzdWUgIzIwODc4IGhhcyBiZWVuIHVwZGF0ZWQgYnkgYnlyb290IChKZWFuIEJvdXNzaWVyKS4N Cg0KDQo+IEkgdGhpbmsgSSB1bmRlcnN0b29kIHdoYXQgeW91IG1lYW50LiBGcm9tIHdoYXQgSSBy ZW1lbWJlciwgY29tcGFjdGlvbiBzaG91bGQgZXhjbHVkZSBvYmplY3RzIHBpbm5lZCBieSByYl9n Y19tYXJrKCkgb3IgcmVmZXJlbmNlZCBmcm9tIHRoZSBtYWNoaW5lIHN0YWNrLg0KDQpZb3UgYXJl IGNvcnJlY3QuDQoNCj4gSW4gdGhlIFRpbWUjc3RyZnRpbWUgZXhhbXBsZSwgbXVjaCBmZXdlciBy Yl9zdHJfc2V0X2xlbigpIGNhbGxzIHNob3VsZCBiZSBuZWNlc3Nhcnkgc2luY2UgdGhlIFN0cmlu ZyB3b3VsZCBiZSBhbHdheXMgb24gdGhlIHN0YWNrLg0KDQpJIGRvbid0IHRoaW5rIG1hbnkgb2Yg dGhlc2UgY291bGQgcmVhbGx5IGJlIGVsdWRlZCwgYmVjYXVzZSB5b3UgbmVlZCB0byBjYWxsIGl0 IGJlZm9yZSBldmVyeSBvdGhlciBjYWxsIHRvIGEgYHJiX3N0cl9gIG1ldGhvZCwgZS5nOg0KDQpg YGBjDQovLyBmcm9tIHN0cmZ0aW1lLmMNCg0KcmJfc3RyX3NldF9sZW4oZnRpbWUsIHMtc3RhcnQp OyAvLyBtdXN0IHNldCB0aGUgbGVuZ3RoIGJlZm9yZSBjYWxsaW5nIHJiX3N0cl9hcHBlbmQNCnJi X3N0cl9hcHBlbmQoZnRpbWUsIHRtcCk7IA0KUlNUUklOR19HRVRNRU0oZnRpbWUsIHMsIGxlbik7 IC8vIHJiX3N0cl9hcHBlbmQgaGF2ZSBjaGFuZ2VkIHRoZSBsZW5ndGggYW5kIHBvdGVudGlhbGx5 IHRoZSBwb2ludGVyLg0KYGBgDQoNCj4gVGhlIE5VTCB0ZXJtaW5hdG9yIGlzIGFuIGltcGxlbWVu dGF0aW9uIGRldGFpbCBsZWZ0IG91dCBmcm9tIHRoZSBwdWJsaWMgQVBJIHNvIGZhciBbLi4uXSBJ J20gbm90IHN1cmUgaWYgZXhwb3NpbmcgaXQgaXMgYSBnb29kIGlkZWEuDQoNClRoYXQncyBhIHZl cnkgZ29vZCBwb2ludC4gSSB0aGluayBpdCBjb3VsZCBiZSByZXBocmFzZWQgdG8gc2F5IHRoZSBO VUwgdGVybWluYXRvciBpcyBvcHRpb25hbC4gR2l2ZW4gdGhlIHBvaW50ZXIgaXMgc2VtYW50aWNh bGx5IGFkb3B0ZXIgYXMgc29vbiBhcyB0aGUgZnVuY3Rpb24gaXMgY2FsbGVkLCBpdCBjb3VsZCBk byBhIGByZWFsbG9jYCBpcyBuZWVkZWQgdG8gYWRkIHRoZSB0ZXJtaW5hdG9yLiBNYWtpbmcgaXQg YW4gaW1wbGVtZW50YXRpb24gZGV0YWlsLg0KDQotLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tDQpGZWF0dXJlICMyMDg3ODogQSBuZXcgQyBBUEkgdG8gY3JlYXRlIGEgU3Ry aW5nIGJ5IGFkb3B0aW5nIGEgcG9pbnRlcjogYHJiX2VuY19zdHJfYWRvcHQoY29uc3QgY2hhciAq cHRyLCBsb25nIGxlbiwgbG9uZyBjYXBhLCByYl9lbmNvZGluZyAqZW5jKWANCmh0dHBzOi8vYnVn cy5ydWJ5LWxhbmcub3JnL2lzc3Vlcy8yMDg3OCNjaGFuZ2UtMTEwOTk1DQoNCiogQXV0aG9yOiBi eXJvb3QgKEplYW4gQm91c3NpZXIpDQoqIFN0YXR1czogT3Blbg0KLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0tLS0tLS0tLS0tLS0tLQ0KIyMjIENvbnRleHQNCg0KQSBjb21tb24gdXNlIGNhc2Ug d2hlbiB3cml0aW5nIEMgZXh0ZW5zaW9ucyBpcyB0byBnZW5lcmF0ZSB0ZXh0IG9yIGJ5dGVzIGlu dG8gYSBidWZmZXIsIGFuZCB0byByZXR1cm4gaXQgYmFjaw0Kd3JhcHBlZCBpbnRvIGEgUnVieSBT dHJpbmcuIEV4YW1wbGVzIGFyZSBgSlNPTi5nZW5lcmF0ZShvYmopIC0+IFN0cmluZ2AsIGFuZCBh bGwgb3RoZXIgZm9ybWF0IHNlcmlhbGl6ZXJzLA0KY29tcHJlc3Npb24gbGlicmFyaWVzIHN1Y2gg YXMgYFpMaWIuZGVmbGF0ZWAsIGV0YywgYnV0IGFsc28gbWV0aG9kcyBzdWNoIGFzIGBUaW1lLnN0 cmZ0aW1lYCwgDQoNCiMjIyBDdXJyZW50IFNvbHV0aW9uDQoNCiMjIyMgV29yayBpbiBhIGJ1ZmZl ciBhbmQgY29weSB0aGUgcmVzdWx0DQoNClRoZSBtb3N0IG9mdGVuIHVzZWQgc29sdXRpb24gaXMg dG8gd29yayB3aXRoIGEgbmF0aXZlIGJ1ZmZlciBhbmQgdG8gbWFuYWdlIGEgbmF0aXZlIGFsbG9j YXRlZCBidWZmZXIsDQphbmQgb25jZSB0aGUgZ2VuZXJhdGlvbiBpcyBkb25lLCBjYWxsIGByYl9z dHJfbmV3KmAgdG8gY29weSB0aGUgcmVzdWx0IGluc2lkZSBtZW1vcnkgbWFuYWdlZCBieSBSdWJ5 Lg0KDQpJdCB3b3JrcywgYnV0IGlzbid0IHZlcnkgZWZmaWNpZW50IGJlY2F1c2UgaXQgY2F1c2Ug YW4gZXh0cmEgY29weSBhbmQgYW4gZXh0cmEgYGZyZWUoKWAuDQoNCk9uIGBydWJ5L2pzb25gIG1h Y3JvLWJlbmNobWFya3MsIHRoaXMgcmVwcmVzZW50IGFyb3VuZCA1JSBvZiB0aGUgdGltZSBzcGVu dCBpbiBgSlNPTi5nZW5lcmF0ZWAuDQoNCmBgYGMNCnN0YXRpYyB2b2lkIGZidWZmZXJfZnJlZShG QnVmZmVyICpmYikNCnsNCiAgICBpZiAoZmItPnB0ciAmJiBmYi0+dHlwZSA9PSBGQlVGRkVSX0hF QVBfQUxMT0NBVEVEKSB7DQogICAgICAgIHJ1YnlfeGZyZWUoZmItPnB0cik7DQogICAgfQ0KfQ0K DQpzdGF0aWMgVkFMVUUgZmJ1ZmZlcl90b19zKEZCdWZmZXIgKmZiKQ0Kew0KICAgIFZBTFVFIHJl c3VsdCA9IHJiX3V0Zjhfc3RyX25ldyhGQlVGRkVSX1BUUihmYiksIEZCVUZGRVJfTEVOKGZiKSk7 DQogICAgZmJ1ZmZlcl9mcmVlKGZiKTsNCiAgICByZXR1cm4gcmVzdWx0Ow0KfQ0KYGBgDQoNCiMj IyMgV29yayBpbnNpZGUgUlN0cmluZyBhbGxvY2F0ZWQgbWVtb3J5DQoNCkFub3RoZXIgd2F5IHRo aXMgaXMgY3VycmVudGx5IGRvbmUsIGlzIHRvIGFsbG9jYXRlIGFuIGBSU3RyaW5nYCB1c2luZyBg cmJfc3RyX2J1Zl9uZXdgLA0KYW5kIHdyaXRlIGludG8gaXQgd2l0aCB2YXJpb3VzIGZ1bmN0aW9u cyBzdWNoIGFzIGByYl9zdHJfY2F0ZmAsDQpvciB3cml0aW5nIHBhc3QgYFJTdHJpbmcubGVuYCB0 aHJvdWdoIGBSU1RSSU5HX1BUUmAgYW5kIHRoZW4gcmVzaXplIGl0IHdpdGggYHJiX3N0cl9zZXRf bGVuYC4NCg0KVGhlIGRvd25zaWRlIHdpdGggdGhpcyBhcHByb2FjaCBpcyB0aGF0IGl0IGNvbnRh aW5zIGEgbG90IG9mIGluZWZmaWNpZW5jaWVzLCBhcyBgcmJfc3RyX3NldF9sZW5gIHdpbGwgcGVy Zm9ybQ0KbnVtZXJvdXMgc2FmZXR5IGNoZWNrcywgY29tcHV0ZSBjb2RlcmFuZ2UsIGFuZCB3cml0 ZSB0aGUgc3RyaW5nIHRlcm1pbmF0b3Igb24gZXZlcnkgaW52b2NhdGlvbi4NCg0KQW5vdGhlciBt YWpvciBpbm5lZmljaWVuY3kgaXMgdGhhdCB0aGlzIEFQSSBtYWtlIGl0IGhhcmQgdG8gYmUgaW4g Y29udHJvbCBvZiB0aGUgYnVmZmVyDQpncm93dGgsIHNvIGl0IGNhbiByZXN1bHQgaW4gYSBsb3Qg bW9yZSBgcmVhbGxvYygpYCBjYWxscyB0aGFuIG1hbnVhbGx5IG1hbmFnaW5nIHRoZSBidWZmZXIu DQoNClRoaXMgbWV0aG9kIGlzIHVzZWQgYnkgYEtlcm5lbCNzcHJpbnRmYCwgYFRpbWUjc3RyZnRp bWVgIGV0YywgYW5kIHdoZW4gSSBhdHRlbXB0ZWQgdG8gaW1wcm92ZSBgVGltZSNzdHJmdGltZWAN CnBlcmZvcm1hbmNlLCB0aGlzIHByb2JsZW0gc2hvd2VkIHVwIGFzIHRoZSBiaWdnZXN0IGJvdHRs ZW5lY2s6DQoNCiAgLSBodHRwczovL2dpdGh1Yi5jb20vcnVieS9ydWJ5L3B1bGwvMTE1NDcNCiAg LSBodHRwczovL2dpdGh1Yi5jb20vcnVieS9ydWJ5L3B1bGwvMTE1NDQNCiAgLSBodHRwczovL2dp dGh1Yi5jb20vcnVieS9ydWJ5L3B1bGwvMTE1NDINCg0KIyMjIFByb3Bvc2VkIEFQSQ0KDQpJIHRo aW5rIGEgbW9yZSBlZmZjaWVudCB3YXkgdG8gZG8gdGhpcyB3b3VsZCBiZSB0byB3b3JrIHdpdGgg YSBuYXRpdmUgYnVmZmVyLCBhbmQgdGhlbiBidWlsZCBhIFJTdHJpbmcNCnRoYXQgImFkb3B0IiB0 aGUgbWVtb3J5IHJlZ2lvbi4NCg0KVGVjaG5pY2FsbHksIHlvdSBjYW4gY3VycmVudGx5IGRvIHRo aXMgYnkgcmVhY2hpbmcgZGlyZWN0bHkgaW50byBgUlN0cmluZ2AgbWVtYmVycywgYnV0IEkgZG9u J3QgdGhpbmsgaXQncyBjbGVhbiwNCmFuZCBhIGRlZGljYXRlZCBBUEkgd291bGQgYmUgcHJlZmVy YWJsZToNCg0KYGBgYw0KLyoqDQogKiBTaW1pbGFyIHRvIHJiX3N0cl9uZXcoKSwgYnV0IGl0IGFk b3B0cyB0aGUgcG9pbnRlciBpbnN0ZWFkIG9mIGNvcHlpbmcuDQogKg0KICogQHBhcmFtW2luXSAg cHRyICAgICAgICAgICAgIEEgbWVtb3J5IHJlZ2lvbiBvZiBgY2FwYWAgYnl0ZXMgbGVuZ3RoLiBN VVNUIGhhdmUgYmVlbiBhbGxvY2F0ZWQgd2l0aCBgcnVieV94bWFsbG9jYA0KICogQHBhcmFtW2lu XSAgbGVuICAgICAgICAgICAgIExlbmd0aCAgb2YgdGhlIHN0cmluZywgIGluIGJ5dGVzLCAgbm90 IGluY2x1ZGluZyAgdGhlDQogKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgdGVybWluYXRp bmcgTlVMIGNoYXJhY3Rlciwgbm90IGluY2x1ZGluZyBleHRyYSBjYXBhY2l0eS4NCiAqIEBwYXJh bVtpbl0gIGNhcGEgICAgICAgICAgICBUaGUgdXNhYmxlIGxlbmd0aCBvZiBgcHRyYCwgaW4gYnl0 ZXMsICBpbmNsdWRpbmcgIHRoZQ0KICogICAgICAgICAgICAgICAgICAgICAgICAgICAgIHRlcm1p bmF0aW5nIE5VTCBjaGFyYWN0ZXIuDQogKiBAcGFyYW1baW5dICBlbmMgICAgICAgICAgICAgRW5j b2Rpbmcgb2YgYHB0cmAuDQogKiBAZXhjZXB0aW9uICByYl9lQXJnRXJyb3IgICAgYGxlbmAgaXMg bmVnYXRpdmUuDQogKiBAcmV0dXJuICAgICBBbiBpbnN0YW5jZSAgb2YgOjpyYl9jU3RyaW5nLCAg b2YgYGxlbmAgIGJ5dGVzIGxlbmd0aCwgYGNhcGEgLSAxYCBieXRlcyBjYXBhY2l0eSwNCiAqICAg ICAgICAgICAgIGFuZCBvZiBgZW5jYCBlbmNvZGluZy4NCiAqIEBwcmUgICAgICAgIEF0ICBsZWFz dCAgYGNhcGFgIGJ5dGVzICBvZiAgY29udGludW91cyAgbWVtb3J5IHJlZ2lvbiAgc2hhbGwgIGJl DQogKiAgICAgICAgICAgICBhY2Nlc3NpYmxlIHZpYSBgcHRyYC4NCiAqIEBwcmUgICAgICAgIGBw dHJgIE1VU1QgaGF2ZSBiZWVuIGFsbG9jYXRlZCB3aXRoIGBydWJ5X3htYWxsb2NgLg0KICogQHBy ZSAgICAgICAgYHB0cmAgTVVTVCBub3QgYmUgbWFudWFsbHkgZnJlZWQgYWZ0ZXIgYHJiX2VuY19z dHJfYWRvcHRgIGhhcyBiZWVuIGNhbGxlZC4NCiAqIEBub3RlICAgICAgIGBlbmNgIGNhbiBiZSBh ICBudWxsIHBvaW50ZXIuICBJdCBjYW4gYWxzbyBiZSAgc2VlbiBhcyBhIHJvdXRpbmUNCiAqICAg ICAgICAgICAgIGlkZW50aWNhbCB0byByYl91c2FzY2lpX3N0cl9uZXcoKSB0aGVuLg0KICovDQpy Yl9lbmNfc3RyX2Fkb3B0KGNvbnN0IGNoYXIgKnB0ciwgbG9uZyBsZW4sIGxvbmcgY2FwYSwgcmJf ZW5jb2RpbmcgKmVuYyk7DQpgYGANCg0KQW4gYWx0ZXJuYXRpdmUgdG8gdGhlIGBhZG9wdGAgdGVy bSwgY291bGQgYmUgYG1vdmVgLg0KDQoNCi0tLUZpbGVzLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t LS0tLS0tLS0NCkNhcHR1cmUgZOKAmWXMgWNyYW4gMjAyNC0xMi0xMSBhzIAgMTEuMDMuMDgucG5n ICgyNTAgS0IpDQoNCg0KLS0gDQpodHRwczovL2J1Z3MucnVieS1sYW5nLm9yZy8NCiBfX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCiBydWJ5LWNvcmUgbWFpbGlu ZyBsaXN0IC0tIHJ1YnktY29yZUBtbC5ydWJ5LWxhbmcub3JnCiBUbyB1bnN1YnNjcmliZSBzZW5k IGFuIGVtYWlsIHRvIHJ1YnktY29yZS1sZWF2ZUBtbC5ydWJ5LWxhbmcub3JnCiBydWJ5LWNvcmUg aW5mbyAtLSBodHRwczovL21sLnJ1YnktbGFuZy5vcmcvbWFpbG1hbjMvbGlzdHMvcnVieS1jb3Jl Lm1sLnJ1YnktbGFuZy5vcmcv