{"id":11884,"date":"2024-01-04T11:00:01","date_gmt":"2024-01-04T16:00:01","guid":{"rendered":"https:\/\/irreal.org\/blog\/?p=11884"},"modified":"2024-01-04T11:00:01","modified_gmt":"2024-01-04T16:00:01","slug":"extracting-text-from-an-emacs-buffer","status":"publish","type":"post","link":"https:\/\/irreal.org\/blog\/?p=11884","title":{"rendered":"Extracting Text From An Emacs Buffer"},"content":{"rendered":"

\nRajasegar Chandran has an interesting and useful post<\/a> on how to extract text from an Emacs buffer. You wouldn’t think there’s a lot to know but there are at least two wrinkles. First you might not want the whole buffer and second you (probably) don’t want to include the text properties.\n<\/p>\n

\nText properties are things like font faces that allow Emacs to display text as “rich text”. They’re really useful but if you want to work on just the underlying text, they can get in the way so, of course, Emacs gives you a way to omit them.\n<\/p>\n

\nTo deal with all this there are four functions that cover most of what you’d want to do.\n<\/p>\n

\n
buffer-substring<\/code><\/dt>\n
Extract a substring including its text properties from the buffer.<\/dd>\n
buffer-substring-no-properties<\/code><\/dt>\n
Like buffer-substring<\/code> but strips the text properties.<\/dd>\n
buffer-string<\/code><\/dt>\n
Extract the entire buffer as a string. The text properties are included.<\/dd>\n
thing-at-point<\/code><\/dt>\n
Return the object that the point is on.<\/dd>\n<\/dl>\n

\nMost of these are self explanatory but thing-at-point<\/code> is a bit richer. You can specify the type of object you want to extract such as a symbol, list, url, filename, email address, or many other object types. It’s sister function bounds-of-thing-at-point<\/code> returns the start and end of the object. It’s really useful if you want to extract, say, a URL from the buffer.\n<\/p>\n

\nThese function are more useful than you might think. My init.el<\/code> has several instances of buffer-substring-no-properties<\/code> and thing-at-point<\/code> just for my personal configuration. If you’re not familiar with them, take a look at Chandran’s post.<\/p>\n","protected":false},"excerpt":{"rendered":"

Rajasegar Chandran has an interesting and useful post on how to extract text from an Emacs buffer. You wouldn’t think there’s a lot to know but there are at least two wrinkles. First you might not want the whole buffer … Continue reading →<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[5],"tags":[18],"class_list":["post-11884","post","type-post","status-publish","format-standard","hentry","category-general","tag-emacs"],"_links":{"self":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/11884","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=11884"}],"version-history":[{"count":1,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/11884\/revisions"}],"predecessor-version":[{"id":11885,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=\/wp\/v2\/posts\/11884\/revisions\/11885"}],"wp:attachment":[{"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=11884"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=11884"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/irreal.org\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=11884"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}